FrameOS
Devices

Pimoroni HyperPixel 2.1" round LCD

A round 480×480 touch LCD on the Pi's GPIO header.

Official Pimoroni store

Official store page for this device.

Buy from Pimoroni
Vendor
Pimoroni
Model
HyperPixel 2.1" Round
Technology
LCD
Colors
262K (18-bit RGB)
Resolution
480×480 px
Size
2.1″ diagonal
Interface
GPIO (DPI)
Platforms
Raspberry Pi
Status
🟢 Confirmed working
FrameOS driver
pimoroni.hyperpixel2r_native

Part of the FrameOS device database. Spotted an error, or tested this panel? Edit this page on GitHub - it's a markdown file.

What to buy

  • The HyperPixel 2.1" Round display from Pimoroni.
  • A Raspberry Pi Zero 2 W (preferred) or Zero W.
  • A 40-pin GPIO header to solder onto the Pi - or buy the pre-pinned Zero WH/W2H and skip the soldering.

Setup

FrameOS has two drivers for this panel:

  • Pimoroni HyperPixel 2.1 Round (native) - try this first on current Raspberry Pi OS.
  • Pimoroni HyperPixel 2.1 Round - the legacy framebuffer driver, for the Bullseye-based setup below.

For the legacy route, install Raspberry Pi OS (Legacy) Lite - "Bullseye", then SSH in and run:

sudo apt -y update
sudo apt -y install git
git clone https://github.com/pimoroni/hyperpixel2r
cd hyperpixel2r
sudo ./install.sh
# remove 3d acceleration
sudo sed -i '/dtoverlay=vc4-kms-v3d/s/^/#/' /boot/config.txt
sudo reboot

After the reboot the screen shows the Linux boot log. Add the frame in the backend, pick the HyperPixel driver, and deploy.

Brightness control

The backlight is on BCM pin 19 (PWM):

sudo apt install wiringpi
gpio -g mode 19 pwm   # set the pin to PWM mode
gpio -g pwm 19 60     # 0-24 off, 25-90 dimmed, 91-1023 full brightness

3D models

A community case design is available on Cults3D.

On this page

What to buySetupBrightness control3D models