FrameOSPimoroni HyperPixel 4.0" Square
A square 720×720 LCD on the Pi's GPIO header, driven natively on a Pi Zero through Pi 5.
Official Pimoroni store
Official store page for this device.
- Vendor
- Pimoroni
- Model
- HyperPixel 4.0" Square
- Technology
- LCD
- Colors
- 262K (18-bit RGB)
- Resolution
- 720×720 px
- Size
- 4″ diagonal
- Interface
- GPIO (DPI)
- Platforms
- Raspberry Pi
- Status
- 🟡 Should work
- FrameOS driver
pimoroni.hyperpixel4sq
Part of the FrameOS device database. Spotted an error, or tested this panel? Edit this page on GitHub - it's a markdown file.
The Pimoroni HyperPixel 4.0" Square is a 4″ IPS LCD with a resolution of 720×720 pixels in 18-bit colour. It sits on the Pi's 40-pin header and the pixels travel over DPI - no HDMI cable, and a refresh is instant. That makes it a good fit for clocks, dashboards and anything that animates.
Pimoroni sells this board with and without touch, and as a rectangular 480×800 sibling - pick the FrameOS device that matches yours: HyperPixel 4.0", HyperPixel 4.0" Touch, HyperPixel 4.0" Square Touch. The smaller round one is the HyperPixel 2.1" Round.
Needs FrameOS 2026.9.20 or newer.
How it works
One native driver covers every HyperPixel 4.0 - no Pimoroni installer, no Python. On the first
deploy its setup writes what the panel needs into config.txt and the frame reboots once. How the
pixels get to the glass depends on the Pi, which the frame detects by itself:
- Pi Zero to Pi 4 - the Pi's firmware drives DPI into
/dev/fb0, and FrameOS sends the panel its init sequence and switches the backlight over GPIO. - Pi 5 - a Pi 5 has no firmware DPI, so setup enables the kernel's
vc4-kms-dpi-hyperpixel4sqoverlay instead and FrameOS only writes the framebuffer.
Setup
- Plug the display onto the Pi's GPIO header. On a Pi Zero that means soldering a header first - or buy the pre-pinned WH / 2 WH.
- Add a frame and select the Pimoroni HyperPixel 4.0" Square device.
- Save & deploy. The first deploy reboots the Pi once, then the scene appears.
The HyperPixel takes every GPIO pin, so the Pi's I2C and SPI buses are switched off while it is the frame's display - no other HATs or GPIO buttons alongside it. Turn display off / on (from the frame's menu, or on a schedule) switches the backlight; there is no dimming.
Moving the SD card to a different HyperPixel is fine: change the device, deploy, and setup swaps
the config.txt lines over.
Status
🟡 Should work, not yet confirmed on real hardware. The driver is confirmed on the HyperPixel 4.0" Touch with a Pi 5; this variant uses Pimoroni's own init sequence and timings but hasn't met a panel yet. If you have this display, tell us on GitHub or Discord and we'll mark it confirmed.