# Hyperpixel 4 not working

**URL:** <https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720>\
**Category:** Support\
**Created:** [May 4, 2025, 11:05am UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720 "2025-05-04T11:05:51Z")\
**Posts on this page:** 18\
**Page:** 1

<div class="post-metadata">

**Author:** ![killjoy7477](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/killjoy7477/32/11625_2.png) [@killjoy7477](https://forums.pimoroni.com/u/killjoy7477)\
**Post date:** [May 4, 2025, 11:05am UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/1 "2025-05-04T11:05:51Z")

</div>

Hi, I just received a brand new Hyperpixel 4 (Rectangular and no touchscreen), to use with my Cyberdeck HAT and Pi 400 (both also brand new) but I can’t get anything to display on the Hyperpixel. I followed the instructions for setting it up on the most recent update and have tried to use the legacy installer and a few other ways. I briefly managed to get the screen to show by using the line for the square version but it was completely unusable. I tried to get help in a Pi server and with the help of someone in there, we’ve come to the conclusion that it’s blindly enabling the screen even when it’s unplugged. I have cut the trace on the Cyberdeck and some fresh installs to try and get this to work.  
Any help would be greatly appreciated.

---

<div class="post-metadata">

**Author:** ![m1cr0py7h0n](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/m1cr0py7h0n/32/11507_2.png) [@m1cr0py7h0n](https://forums.pimoroni.com/u/m1cr0py7h0n)\
**Post date:** [May 4, 2025, 4:49pm UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/2 "2025-05-04T16:49:34Z")

</div>

> [@killjoy7477](#):
>
> I can’t get anything to display on the Hyperpixel

are there any errors displayed?  
The usual problem is that the drivers (PIMORONI installation scripts) are not installed properly in the right DEV environment…

…have you checked this out already?

---

<div class="post-metadata">

**Author:** ![killjoy7477](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/killjoy7477/32/11625_2.png) [@killjoy7477](https://forums.pimoroni.com/u/killjoy7477)\
**Post date:** [May 4, 2025, 5:05pm UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/3 "2025-05-04T17:05:02Z")

</div>

There’s no errors that I can see on the Pi itself and there’s nothing but a black screen on the Hyperpixel. How would I check if they were installed in the right DEV environment?

---

<div class="post-metadata">

**Author:** ![m1cr0py7h0n](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/m1cr0py7h0n/32/11507_2.png) [@m1cr0py7h0n](https://forums.pimoroni.com/u/m1cr0py7h0n)\
**Post date:** [May 4, 2025, 5:45pm UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/4 "2025-05-04T17:45:21Z")

</div>

You usually get a permissions warning that the installation is not in the right ENV…

Which RaspberryOS is running underneath? Did you already tried the lastest one?  
To which RaspberryPI do you connect the HypePixel Display?  
Did you already wrote an email to the Pimoroni support team?

---

<div class="post-metadata">

**Author:** ![killjoy7477](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/killjoy7477/32/11625_2.png) [@killjoy7477](https://forums.pimoroni.com/u/killjoy7477)\
**Post date:** [May 4, 2025, 6:25pm UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/5 "2025-05-04T18:25:33Z")

</div>

It’s the latest update of whatever the normal Pi OS is called and it’s on a Pi 400. I’ve not yet emailed the support team, didn’t know if it’d be an easy fix or not.

---

<div class="post-metadata">

**Author:** ![m1cr0py7h0n](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/m1cr0py7h0n/32/11507_2.png) [@m1cr0py7h0n](https://forums.pimoroni.com/u/m1cr0py7h0n)\
**Post date:** [May 4, 2025, 7:40pm UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/6 "2025-05-04T19:40:17Z")

</div>

The thing is that Pimoroni should be aware of the fact that many users complain with the use of the display since the new RaspberryPiOS‘ change (I think it was 2023 or 2024).  
The more users mail-in the more it gets attention…

This is a users‘ forum and most likely this is not a problem users can solve, so you need to bring this to the manufacturers attention…

@hel are you aware the fact that the hyperpixel displays cause a lot of trouble during operation with modern Raspberry installations…I find many threads talking about the same issues…

---

<div class="post-metadata">

**Author:** ![m1cr0py7h0n](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/m1cr0py7h0n/32/11507_2.png) [@m1cr0py7h0n](https://forums.pimoroni.com/u/m1cr0py7h0n)\
**Post date:** [May 4, 2025, 7:43pm UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/7 "2025-05-04T19:43:13Z")

</div>

I can‘t remember exactly the parameters, but have you enabled the interfaces (sudo raspi-config) and set up the boot config files accordingly…?

---

<div class="post-metadata">

**Author:** ![killjoy7477](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/killjoy7477/32/11625_2.png) [@killjoy7477](https://forums.pimoroni.com/u/killjoy7477)\
**Post date:** [May 4, 2025, 7:51pm UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/8 "2025-05-04T19:51:44Z")

</div>

I wasn’t aware there was anything I had to do in raspi-config. The instructions just said you had to add a line to the config.txt and it should work. I will send an email soon but I wonder if it’d be worth just using an older update for now, assuming that’s something I can do.

---

<div class="post-metadata">

**Author:** ![m1cr0py7h0n](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/m1cr0py7h0n/32/11507_2.png) [@m1cr0py7h0n](https://forums.pimoroni.com/u/m1cr0py7h0n)\
**Post date:** [May 4, 2025, 8:08pm UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/9 "2025-05-04T20:08:21Z")

</div>

no, afaik the older installers don’t work anymore as the handling of the ENVs changed…  
All installations now need to go into virtual environments, which the old installers do not support.

You now need to manually install this stuff into the right environment.

Also [see here](https://www.raspberrypi.com/news/using-python-with-virtual-environments-the-magpi-148/) in MagPi…

Also interesting is the first comment…

 ![pipx](https://us1.discourse-cdn.com/flex016/uploads/pimoroni/original/2X/b/bb69bf6d79ef26d99c1df7998bc193d58290c74b.png)  
I haven’t tried it, though…

This seems to be a doable, but dangerous (no recommended) workaroud during installation:

 ![danger](https://us1.discourse-cdn.com/flex016/uploads/pimoroni/original/2X/3/3412550e667445b110c7ce2ff3403a2d0cf5db58.png)

---

<div class="post-metadata">

**Author:** ![ahnlak](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/ahnlak/32/5610_2.png) [@ahnlak](https://forums.pimoroni.com/u/ahnlak)\
**Post date:** [May 5, 2025, 3:32pm UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/10 "2025-05-05T15:32:48Z")

</div>

I think you’re trying to fix something completely different, @m1cr0py7h0n - the Hyperpixel stuff has absolutely nothing to do with python, so all this talk of venv and random pipx stuff is irrelevant.

The latest RaspberryOS handles Hyperpixels pretty smoothly - the latest and greatest information is probably [here](https://github.com/pimoroni/hyperpixel4/issues/177); you shouldn’t run any (legacy) installers, just add the appropriate line into your `config.txt`.

---

<div class="post-metadata">

**Author:** ![killjoy7477](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/killjoy7477/32/11625_2.png) [@killjoy7477](https://forums.pimoroni.com/u/killjoy7477)\
**Post date:** [May 5, 2025, 5:01pm UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/11 "2025-05-05T17:01:37Z")

</div>

I’ve tried just adding the line to my config and it didn’t work.

---

<div class="post-metadata">

**Author:** ![m1cr0py7h0n](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/m1cr0py7h0n/32/11507_2.png) [@m1cr0py7h0n](https://forums.pimoroni.com/u/m1cr0py7h0n)\
**Post date:** [May 5, 2025, 5:02pm UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/12 "2025-05-05T17:02:50Z")

</div>

You are probably right, I read this in another thread also…

---

<div class="post-metadata">

**Author:** ![m1cr0py7h0n](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/m1cr0py7h0n/32/11507_2.png) [@m1cr0py7h0n](https://forums.pimoroni.com/u/m1cr0py7h0n)\
**Post date:** [May 5, 2025, 6:57pm UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/13 "2025-05-05T18:57:48Z")

</div>

Maybe you should restart with a new image and add the necessary steps manually again…

---

<div class="post-metadata">

**Author:** ![killjoy7477](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/killjoy7477/32/11625_2.png) [@killjoy7477](https://forums.pimoroni.com/u/killjoy7477)\
**Post date:** [May 5, 2025, 7:39pm UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/14 "2025-05-05T19:39:23Z")

</div>

I’ve done that a few times already and nothing changed.

---

<div class="post-metadata">

**Author:** ![ahnlak](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/ahnlak/32/5610_2.png) [@ahnlak](https://forums.pimoroni.com/u/ahnlak)\
**Post date:** [May 5, 2025, 9:06pm UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/15 "2025-05-05T21:06:10Z")

</div>

Just to sanity check; I think the latest OS have shifted `/boot/config.txt` to `/boot/firmware/config.txt`, so it might be worth checking you’ve added the relevant line to the right one.

Other than that… double check that the trace on the Cyberdeck is properly cut (and is the right one!); I can’t quite remember the physical arrangement of the Pi400 - I take it it’s not practical to (for testing anyway) remove the Cyberdeck from the equation?

---

<div class="post-metadata">

**Author:** ![killjoy7477](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/killjoy7477/32/11625_2.png) [@killjoy7477](https://forums.pimoroni.com/u/killjoy7477)\
**Post date:** [May 6, 2025, 7:31am UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/16 "2025-05-06T07:31:47Z")

</div>

I am adding the line to /boot/firmware/config.txt (I have also tried putting it in /boot/config.txt instead). I’m pretty sure the trace is cut properly, there’s nothing left of it and it’s definitely the right one.  
Unfortunately, I don’t have the means of testing the Hyperpixel without the Cyberdeck but I do know that the Cyberdeck works with my 2.8 TFT.

---

<div class="post-metadata">

**Author:** ![ahnlak](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/ahnlak/32/5610_2.png) [@ahnlak](https://forums.pimoroni.com/u/ahnlak)\
**Post date:** [May 6, 2025, 9:34am UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/17 "2025-05-06T09:34:31Z")

</div>

The only other thing(s) I can think of is to ensure that everything is seated fully (but I’m certain you’ve triple checked that by now!), and that you don’t have another display plugged in - or indeed _any_ other hardware, for the purposes of testing at least.

I know I’ve seen some vague talk of connecting the Hyperpixel direct to a pi400 which is … fairly useless because it’s not actually visible, being the wrong way around and everything but might be a path to determining whether the issue is with the display or the cyberdeck.

There are lots of folk who have this combination working, so I’m sure we’ll get to the bottom of it eventually :-)

---

<div class="post-metadata">

**Author:** ![m1cr0py7h0n](https://sea2.discourse-cdn.com/flex016/user_avatar/forums.pimoroni.com/m1cr0py7h0n/32/11507_2.png) [@m1cr0py7h0n](https://forums.pimoroni.com/u/m1cr0py7h0n)\
**Post date:** [May 6, 2025, 9:40am UTC](https://forums.pimoroni.com/t/hyperpixel-4-not-working/27720/18 "2025-05-06T09:40:43Z")

</div>

> [@ahnlak](#):
>
> fairly useless because it’s not actually visible, being the wrong way around and everything

…which “wrong way” are you talking about, physically or logically?

I use this [Pi400 GPIO adapter](https://www.amazon.co.uk/dp/B09BPY1P3Z) and the orientation is just reversed, so you can rotate (by command line) by 180 ° and everything is fine again…
