top of page
ChatGPT Image May 18, 2026, 06_20_40 PM.png

3D DISPLAY HAT RESOURCES

Build Real 3D Visuals With Your Raspberry Pi

The 3D Display Hat uses a high-speed rotating LED system to create floating visuals in mid-air using persistence of vision.

Learn how to setup the hardware, control the motor, synchronize LEDs, and start building your own effects.

ChatGPT Image May 9, 2026, 02_46_01 AM_edited.png

Raspberry Pi
Compatible

ChatGPT Image May 18, 2026, 07_12_34 PM_edited.png

SK9822
LEDs

ChatGPT Image May 18, 2026, 07_12_34 PM_edited.png

DRV10983
Motor Driver

Python-logo-notext.svg.png

Python
Ready

Assembly

Untitled design (67)_edited.png

WARNING: It is necessary to mount the 3d display to the base or to a heavy surface. Otherwise the display can become unstable and injure.

Step 1

Start by screwing your Raspberry Pi to the bottom of the hex spacers on the 3D Display HAT.

Step 2

Plug in the USB-C to the 3D Display HAT to power the Pi and the HAT. Only use the supplied USB-C or make sure yours is 30W or more.

WARNING

3D Display (1)_edited.png

DO NOT TOUCH THE DISPLAY WHILE IT IS SPINNING. Doing so can result in injury.

Pi Setup

Moving the Motor

Once you've started up your Pi there are a few things to note before creating your own holograms. The pin to control the motor is GPIO 4. Setting GPIO 4 to low will spin the motor while setting it to high will stop the motor. Create a simple python file by typing:

sudo nano example.py

In this file set GPIO 4 to low for 5 seconds and then high, this will spin the motor and then turn it off. Type the following:

from gpiozero import OutputDevice

from time import sleep

pin = OutputDevice(4)

pin.off()

sleep(5)

pin.on()

To save hit CTRL+X and type Y to save the changes. Then in the terminal type:

python3 example.py

Turning on the LEDs

This display HAT has 70 Sk9822 LEDs. They are controlled by the clock pin (GPIO 24) and data pin (GPIO 23). To control the LEDs create an example file LED.py

sudo nano LED.py

In this file set GPIO 4 to low for 5 seconds and then high, this will spin the motor and then turn it off. Type the following:

from gpiozero import OutputDevice

from time import sleep

pin = OutputDevice(4)

pin.off()

sleep(5)

pin.on()

Creating a 3D Dot

Once you've started up your Pi there are a few things to note before creating your own holograms. The pin to control the motor is GPIO 4. Setting GPIO 4 to low will spin the motor while setting it to high will stop the motor. Create a simple python file by typing:

sudo nano example.py

In this file set GPIO 4 to low for 5 seconds and then high, this will spin the motor and then turn it off. Type the following:

from gpiozero import OutputDevice

from time import sleep

pin = OutputDevice(4)

pin.off()

sleep(5)

pin.on()

Creating a Square

Once you've started up your Pi there are a few things to note before creating your own holograms. The pin to control the motor is GPIO 4. Setting GPIO 4 to low will spin the motor while setting it to high will stop the motor. Create a simple python file by typing:

sudo nano example.py

In this file set GPIO 4 to low for 5 seconds and then high, this will spin the motor and then turn it off. Type the following:

from gpiozero import OutputDevice

from time import sleep

pin = OutputDevice(4)

pin.off()

sleep(5)

pin.on()

Schematic

3D Display Hat Modern.png
bottom of page