Beginner / 2–3 hours

A little display with a lot to say

Sometimes your project doesn't need a whole screen. It needs a color, a moving light, or a quick way to tell you that something changed. Maybe that's a temperature display on your desk. Maybe it's a status indicator you can update from your phone. A handful of RGB LEDs can do a surprising amount of communicating!

The frustrating part can be getting all the pieces together. An external matrix needs a controller, power, wiring, and somewhere to put everything. PixelWing ESP32-S3 brings the controller and display onto one board, so you can spend more time making the display do something useful.

PixelWing ESP32-S3 with its integrated RGB matrix

What does PixelWing give you?

The matrix uses NeoPixel-compatible addressable RGB LEDs. Each LED receives its color through a chain, so our code sees a list of 50 pixels even though the board arranges them as a rectangle. We'll connect those two views in a moment.

The PixelWing ESP32-S3 product page has the board photos and feature overview.

Angled view of PixelWing showing the board profile and connectors

Explore the open source design

Want to see how PixelWing works underneath the examples? The PixelWing ESP32-S3 open source repository contains the board design and supporting documentation. You can follow a signal through the schematic, explore the PCB layout, or use the design as a starting point for your own hardware project.

You don't need KiCad or a copy of the repository to follow this guide. It's there when you want to look closer. If you find a problem or have a suggestion, open a GitHub issue with your board revision, firmware version, and enough detail for someone else to reproduce it.

The repository's firmware release and example status are separate from its hardware files. Check its getting-started notes and the firmware guidance below before looking for an installable CircuitPython image.

What we're going to build

We'll start with CircuitPython itself: where your code lives, how libraries work, and how to read an error. Then we'll make colors, move a pixel, and turn the LED chain into a coordinate system.

From there we'll use Adafruit's LED Animation library to build effects without writing every frame ourselves. We'll connect an I2C temperature sensor and make a display that responds to the room. Finally, we'll host a small web page on PixelWing and use a browser to change the matrix while the program runs.

Prefer Arduino? Jump straight to Program PixelWing with Arduino for the ESP32-S3 board definition, USB upload setup, and a complete matrix sketch. The other project pages use CircuitPython.

Work through the CircuitPython pages in order for your first project. After that, each project page has a complete replacement code.py, so you can come back to the part you need.

What you'll need

For the first four pages, bring a PixelWing ESP32-S3, a USB-C data cable, and a computer with a text editor and serial console. A charging-only cable can power LEDs while leaving you wondering where the board went.

For the sensor page, we'll use a BME280 I2C breakout with a Qwiic or STEMMA QT connector, plus the matching four-wire cable. The Wi-Fi page needs a 2.4 GHz network and a computer or phone on the same local network. PixelWing ESP32-S3 does not come with an antenna. Buy one separately for Wi-Fi or Bluetooth; the ESP32-S3-MINI-1U module uses an external antenna connector.

We'll keep matrix brightness at 0.05, or five percent, to start. That's a conservative starting setting, not a measured power limit. Fifty bright white LEDs can demand much more current than a few dim colored ones. If the board resets as it lights up, reduce brightness and check your USB cable and supply before continuing.

Choose an antenna

Look for a 2.4 GHz, 50 Ω antenna with a U.FL / IPEX MHF1 connector to match the module. Here are two ways to go:

U.FL and the smaller W.FL / MHF3 or MHF4 connectors aren't interchangeable. Check the connector before ordering. Disconnect USB before fitting the antenna, align the tiny plug directly over the socket, and press gently straight down. Keep the antenna clear of metal and fit it before running wireless examples. USB programming and the LED-only projects don't need an antenna.

A quick note about firmware

This guide targets the ESP32-S3 PixelWing. The older ESP32-S2 version has different pin assignments. The S3 board definition provides board.NEOPIXEL on GPIO48, board.SDA on GPIO21, and board.SCL on GPIO47.

The CircuitPython projects assume PixelWing-specific CircuitPython is already installed. If your board doesn't show a CIRCUITPY drive, follow the firmware notes on the next page before trying the examples.

Next: Get comfortable with CircuitPython.