From Waveshare Wiki
Jump to: navigation, search

RGB LED Matrix Panel 64 × 32 Pixels 3.0mm Pitches





This product is an RGB LED full-color multi-function digital clock, using the Raspberry Pi Pico master control, onboard a variety of peripheral resources, providing C++/Python demos and learning tutorials, open source software and hardware, suitable for makers or electronics enthusiasts to get started learning, or DIY secondary development into other desktop or wall-mounted display applications.


  • Standard Raspberry Pi Pico header, supports Raspberry Pi Pico series.
  • Using P3 fine-pitch RGB LED matrix panel, with 2048 individual RGB LEDs, 64 × 32 pixels, 3mm pitch, allows displaying text, colorful images, or animation.
  • Onboard high precision RTC chip DS3231, with backup battery holder (battery included), maintains accurate timekeeping when main power is off.
    • Real-Time Clock Counts Seconds, Minutes, Hours, Date of the Month, Month, Day of the Week, and Year with Leap-Year Compensation Valid Up to 2100.
    • Optional format: 24-hour OR 12-hour with an AM/PM indicator.
    • 2 x programable alarm clock.
    • Digital temperature sensor output: ±3°C accuracy
  • Embedded photosensor for auto brightness adjustment due to the ambient light, power saving, and eye care.
  • Embedded buzzer for alarm or hourly ring, etc.
  • IR receiver, combined with the IR remote controller, supports IR wireless control.
  • 5 x buttons for configuration, reset, and code programming.
  • Quality acrylic back panel and dimmer panel, better looking, more comfortable displaying.
  • Comes with online development resources and manual (Raspberry Pi Pico C/C++ and MicroPython examples).

Usage Scenarios

Pico-RGB-Matrix-P3-64x32-details-21.jpg Pico-RGB-Matrix-P3-64x32-details-23.jpg

Hardware Introduction

Introduction to Floor Resources


Directions for Raspberry Pi

Please refer to github information: Demo, wiring reference
If the overall brightness of the indicator is dim, click setting to set the brightness.

User Guides for Pico

Pico connection pins

Board Pico Pin description
Pins used by RGB LED Matrix (HUB75 interface)
R1 GP02 R higher bit data
G1 GP03 G higher bit data
B1 GP04 B higher bit data
R2 GP05 R lower bit data
G2 GP08 G lower bit data
B2 GP09 B lower bit data
A GP10 A line selection
B GP16 B line selection
C GP18 C line selection
D GP20 D line selection
E GP22 E line selection
CLK GP11 clock input
STB/LAT GP12 latch pin
OE GP13 output enable


Board Pico Pin description
Pins used by other resources of the board
K0 GP15 KEY0 button, the MENU menu of the digital clock, can also be customized
K1 GP19 KEY1 button, + / Down button of digital clock, can also be customized
K2 GP21 KEY2 button,-/ UP button of digital clock, can also be customized
RUN RUN RESET button, can be used for Pico reset
BOOTSET BOOTSET BOOT button, can be used for Pico burning program (long press BOOT, then press RESET to enter the firmware download mode)
SDA GP06 I2C data pin, used to control DS3231 RTC clock chip
SCL GP07 I2C clock pin, used to control DS3231 RTC clock chip
BUZZ GP27 Buzzer control pin
AIN GP26 Photoresistor control pin
IRM GP28 Infrared receiving control pin

See detailed hardware design of the circuit diagram.

Hardware Connection

Materials needed
  • Pico-RGB-Matrix-P3-64 x 32 (this product).
  • Raspberry Pi Pico (must be purchased separately, if not, it is recommended to buy a version with soldered headers, which is convenient for direct insertion and use).
  • Micro USB cable (must be purchased separately).
Hardware connection steps
  1. Align the pin header which is marked in red and then connect the RGB LED Matrix panel to the driver board.
  2. Cut the adapter cable (about 10cm) by plier
  3. Connect the cable which is cut in the last step to the RGB LED Matrix and the driver board
  4. Assemble the Acrylic backplane and fix it with magnetic screws
  5. Optional: If you feel that the RGB LED Matrix is too bright, you can stick the black Acrylic font panel on the Matrix.

Example display

Multi-Features Digital Clock

This example is developed based on the C++ SDK. In order to quickly demonstrate the effects and functions of the example, you can skip the steps of "#C++ SDK Development Tutorial" and "Program Debugging and Development" and directly "#Download and burn programs". After the burning is completed, the effect of the instance running is shown in the following figure:


【Function Description】

  • Time display screen:
    • Display date, day of the week, hour, minute, lunar calendar and temperature
  • Function setting menu
    • Date setting
    • time setting
    • BEEP setting (buzzer setting)
    • Auto brightness
    • Language setting (under development)
Fruit machine

This example is developed based on CircuitPython[1] , and the program is downloaded[2] . The effects and functions of the example are as follows:


【Function Description】

  • The display can display a variety of fruits or other small BMP icons
  • Automatically scroll icons at regular intervals, and randomly display the results of the scrolling
  1. CircuitPython is a fork of MicroPython, For specific usage, please refer to the RGB-Matrix related CircuitPython tutorial
  2. Pico must first install CircuitPython,and then copy the corresponding CircuitPythond code to the recognized U disk to complete the download.
Infrared transceiver test

This example is developed based on CircuitPython,and the example effects and functions are as follows:


【Function Description】

  • The infrared serial code generated by the corresponding button of the infrared remote control can be recognized

C++ SDK Development Tutorial

Development environment setup

For a complete tutorial on how to get started with the C/C++ SDK, You can directly refer to the Offical manual of Raspberry Pi.

Raspberry Pi development environment setup

If you plan to develop for Pico on the Raspberry Pi, you can quickly set up the C/C++ toolchain by running our "setup script" from the command line.
Instructions: Before running the installation script, you should make sure that the operating system on your Raspberry Pi is up to date.

Windows development environment setup

For Windows development environment construction, please refer to:

Download and burn programs

C++ SDK program programming

The following is an example of programming a simple "blinking LED" program:

  1. Download blink.uf2 ("Blink LED" flash file)
  2. Press and hold the BOOTSEL button, then plug the Pico into the USB port of your Raspberry Pi or other computer.
  3. It will be mounted as a mass storage device named "RPI-RP2". Drag and drop the blink.uf2 binary onto the "RPI-RP2" drive letter. The Pico will restart and the onboard LEDs should start blinking.


CircuitPython Development Tutorial

If you are not familiar with CircuitPython, you can first study the official recommended guide "Introduction to CircuitPython for Raspberry Pi Pico".
This guide covers the basics of getting started with CircuitPython and using the editor.

Development environment setup

In order to facilitate the programming, development and debugging of CircuitPython, it is recommended to use the "Mu Editor" development software. You can use Mu Editor for Pico's CircuitPython development on Windows.
The following describes the development and use of Mu Editor under Windows.

Windows development environment (Mu Editor) build and use

  • Download Mu Editor and follow the steps to install
  • After the installation is complete, it is the first time to configure the language and select the mode. Since we are using CircuitPython, pay attention to the mode selection CircuitPython option.
  • After the configuration is complete, it will show that the device cannot be found, that is because Pico has not downloaded the CircuitPython firmware library.
  • Download the CircuitPython firmware library and burn it into Pico
  1. Download the CircuitPython UF2 file.
  2. Press and hold the BOOTSEL button, then plug the Pico into the USB port of your Raspberry Pi or other computer. Release the BOOTSEL button after connecting the Pico.
  3. It will be mounted as a mass storage device named "RPI-RP2".
  4. Drag and drop the CircuitPython UF2 file onto the "RPI-RP2" volume. Your Pico will reboot, a new disk drive named CIRCUITPY will appear, and you're done.
  5. The new disk drive will have a default code.py file, you open it with Mu Editor, the content is: "print("Hello World!")", the specific opening steps are shown in the last figure.
  • Open the serial port, click the blank area and press Ctrl+C, then press Ctrl+D or click the blank area of ​​the code interface and press Ctrl+S to run the program. You can observe the running effect in the CircuitPython REPL window.

User Guides of ESP32-S2-Pico

Environment Setting Up

The demo is based on Arduino, please refer to Arduino Environment.


Note: A Pico baseplate is required for use here. Click to download the program, after the download is complete, go to Pico-RGB-Matrix-P3-64x32-Demo\ESP32-S2-Pico\Arduino,

  1. Copy RGBMatrix-master to the libraries in the Arduino installation directory;
  2. Go back to RGB-Matrix-P3-64x32-Demo\\ESP32-S2-Pico\Arduino, open the .ino file in EzTimeTetrisClockESP32S2 and follow the steps below to download



Display Effect



  • Time display interface:
    • Display date, week, hour, minute, lunar calendar, and temperature
  • Function setting menu
    • Date setting
    • Time setting
    • BEEP setting (beep setting)
    • Auto Brightness
    • Language settings



Development Software

Pico Quick Start

Download Firmware

  • MicroPython Firmware Download

MicroPython Firmware Download.gif

  • C_Blink Firmware Download

C Blink Download.gif

Video Tutorial

  • Pico Tutorial I - Basic Introduction

  • Pico Tutorial II - GPIO

  • Pico Tutorial III - PWM

  • Pico Tutorial IV - ADC

  • Pico Tutorial V - UART

  • Pico Tutorial VI - To be continued...

MicroPython Series

C/C++ Series

Arduino IDE Series

Install Arduino IDE

  1. Download the Arduino IDE installation package from Arduino website.
    RoArm-M1 Tutorial II01.jpg
  2. Just click on "JUST DOWNLOAD".
    Arduino IDE Pico.png
  3. Click to install after downloading.
    RoArm-M1 Tutorial II02.gif
  4. Note: You will be prompted to install the driver during the installation process, we can click Install.

Install Arduino-Pico Core on Arduino IDE

  1. Open Arduino IDE, click the File on the left corner and choose "Preferences".
    RoArm-M1 Tutorial04.jpg
  2. Add the following link in the additional development board manager URL, then click OK.

    RoArm-M1 Tutorial II05.jpg
    Note: If you already have the ESP8266 board URL, you can separate the URLs with commas like this:

  3. Click on Tools -> Dev Board -> Dev Board Manager -> Search for pico, it shows installed since my computer has already installed it.
    Pico Get Start 05.png
    Pico Get Start 06.png

Upload Demo At the First Time

  1. Press and hold the BOOTSET button on the Pico board, connect the Pico to the USB port of the computer via the Micro USB cable, and release the button when the computer recognizes a removable hard drive (RPI-RP2).
    Pico Get Start.gif
  2. Download the demo, open arduino\PWM\D1-LED path under the D1-LED.ino.
  3. Click Tools -> Port, remember the existing COM, do not need to click this COM (different computers show different COM, remember the existing COM on your computer).
    UGV1 doenload02EN.png
  4. Connect the driver board to the computer with a USB cable, then click Tools -> Ports, select uf2 Board for the first connection, and after the upload is complete, connecting again will result in an additional COM port.
    UGV1 doenload03EN.png
  5. Click Tool -> Dev Board -> Raspberry Pi Pico/RP2040 -> Raspberry Pi Pico.
    Pico Get Start02.png
  6. After setting, click the right arrow to upload.
    Pico Get Start03.png
    • If you encounter problems during the period, you need to reinstall or replace the Arduino IDE version, uninstall the Arduino IDE needs to be uninstalled cleanly, after uninstalling the software you need to manually delete all the contents of the folder C:\Users\[name]\AppData\Local\Arduino15 (you need to show the hidden files in order to see it) and then reinstall.

Pico-W Series Tutorial (To be continued...)

Open Source Demo


Technical Support

If you need technical support or have any feedback/review, please click the Submit Now button to submit a ticket, Our support team will check and reply to you within 1 to 2 working days. Please be patient as we make every effort to help you to resolve the issue.
Working Time: 9 AM - 6 AM GMT+8 (Monday to Friday)