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 color. 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.22 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. On
every Pi, Zero to Pi 5, that's the kernel's own vc4-kms-dpi-hyperpixel4sq overlay (FrameOS
2026.9.22+): the kernel brings the panel up and FrameOS only writes the framebuffer. A card set up
by an older release, with the firmware's DPI lines in config.txt, is converted on its next driver
setup.
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) blanks the panel; 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 same overlay drives the confirmed HyperPixel 4.0" Square Touch on a Pi Zero W; this variant, without the touch controller, hasn't met a panel yet. If you have this display, tell us on GitHub or Discord and we'll mark it confirmed.