

Led matrix
Python / C control for a LED matrix
- Size
- 38 × 38 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 9
- Nets
- 24
- Pads
- 58
- Tracks, vias
- 139, 12
- Pours
- 1
- Routed
- Yes
- KiCad
- KiCad 6 (file 20211014)
- Created
- 5 Oct 2020
- Updated
- 9 Mar 2026
Overview
Led matrix is an open-source printed circuit board by Riik, from the Riik/led-matrix repository on GitHub. It is a 2-layer board of 38 × 38 mm with 9 parts on 24 nets, routed with 139 tracks and 12 vias.
It is built around the MAX7219M. Its parts include 2 connectors, 1 capacitor, 1 resistor, 1 IC and 1 diode. It belongs with the lEDs and displays boards of this library.
Main components
1README
README.mdrpi-led-matrix
Python / C control for a LED matrix
Goal
Create the software for a hardware project which can drive a LED matrix with a extendable number of rows and columns
Hardware
To drive the rows, the MIC2981 driver IC is used. It can source up to 500mA per pin, which mean 25 columns @ 20mA / column. To sink the columns, the TPIC6C595 is used. I needs to be able to sink one column (20mA) per pin, so for an 8 bit shift register the total IC must be able to sink 8*20mA. The TPIC6C595 is able to sink up to 100mA per pin. The rows should multiplexed, i.e. they should not be one at the same time.
Software
Suitable candidates:
- PIGpio Python library using DMA control http://abyz.me.uk/rpi/pigpio/
- Directly talking to SPI hardware in C using IOCTL
Notes to selfs
- If multiple rows are active, current is split / LEDS are in parallel with respect to the sinking column.
- We probably need a resistor per sink / column
On the subject of the LED matrix 3D model
For this model, we use two programs: OpenSCAD and FreeCAD. OpenSCAD is used to program the model. To make the model readable for KiCad:
- Open FreeCAD
- Select View->Workbench->OpenSCAD
- Open the *.scad file (File->Open)
- In Combo View->Model->Labels & Attributes->2088BS select union
- Go to File->Export
- Export the model as a STEP with colors (*.step *.stp)
Selected components
- 100 Ohm 1206 [3216 Metric]: Vishay CRCW1206100RFKEA (https://nl.farnell.com/vishay/crcw1206100rfkea/res-100r-1-0-25w-1206-thick-film/dp/1469977,
- 10 kOhm 1206 [3216 Metric]: Vishay CRCW120610K0FKEA (https://nl.farnell.com/vishay/crcw120610k0fkea/res-10k-1-0-25w-1206-thick-film/dp/1469970RL,
- 100 nF (0.1 uF) 1206 [3216 Metric] capacitor: Vishay VJ1206Y104KXQCW1BC (https://nl.farnell.com/vishay/vj1206y104kxqcw1bc/cap-0-1-f-10v-10-x7r-1206/dp/2896644RL,
- Pin header male: https://nl.farnell.com/multicomp/mc34753/header-1-row-r-angle-8way/dp/1593431?ost=mc34753,
- Pin header female: https://nl.farnell.com/samtec/ssw-108-02-g-s-ra/receptacle-2-54mm-r-a-single-8way/dp/1668368,
Parts
9| Qty | Value | Footprint | References |
|---|---|---|---|
| 1 | 0.1 uF | Capacitor_SMD:C_1206_3216Metric_Pad1.33x1.80mm_HandSolder | C1 |
| 1 | 1588BS | led-matrix:8x8_led_matrix_38mm | D1 |
| 1 | 28 K | Resistor_SMD:R_1206_3216Metric_Pad1.30x1.75mm_HandSolder | R1 |
| 1 | Conn_02x03_Input | led-matrix:PinSocket_2x03_P2.54mm_Horizontal | J1 |
| 1 | Conn_02x03_Output | Connector_PinHeader_2.54mm:PinHeader_2x03_P2.54mm_Horizontal | J2 |
| 1 | LOGO | led-matrix:logo_scaled | G*** |
| 1 | MAX7219 | led-matrix:HandSolder.SOIC-24W_7.5x15.4mm_P1.27mm | U1 |
The 7 most common of 9 parts.
More from Riik/led-matrix
1- 2 layers59.7 × 59.7 mm

Similar boards
- 2 layers181 × 97 mm

OpenDeck r3.1.2
shanteacontrols/OpenDeck
A platform for building interactive control and sensing devices using MIDI and OSC built with Zephyr RTOS.
262 parts960Apache-2.0 - 2 layers482.6 × 35.6 mm

- 2 layers85.6 × 41 mm

Hl alyx glove
StarGate01/hl-alyx-glove
Firmware and Hardware for a Half-Life: Alyx Gravity Glove Replica
38 parts21MIT - 2 layers191.8 × 48.4 mm

- 2 layers542.3 × 27.3 mm

Glowboardng
Eigenbaukombinat/glowboard
The Glowboard Plotter plots images using 64 UV LEDs attached in a line moved over a 120cmx60cm glow-in-the-dark sheet by a stepper.
69 parts6 - 2 layers70 × 50.1 mm

- 2 layers91.4 × 119.4 mm

- 2 layers142.2 × 64.4 mm

Questions
How big is the Led matrix PCB?
It measures 38 × 38 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Led matrix use?
9 parts, built around the MAX7219M. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
Where can I download the Led matrix KiCad files?
From the Riik/led-matrix repository on GitHub, at the commit this page was made from: the board is v2/kicad/led-matrix/led-matrix.kicad_pcb and its schematic v2/kicad/led-matrix/led-matrix.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Led matrix design in my own project?
Its repository states no licence, so its author keeps all rights: ask Riik before reusing the design.