SmartMatrix Library Wiki

This Wiki is the home of SmartMatrix Library documentation as of the SmartMatrix 4.0 release.

SmartMatrix Library is designed to refresh HUB75 LED matrix panels and APA102-compatible addressable LEDs with high quality graphics, using simple Arduino sketches.

Getting Started

To use the SmartMatrix library to control an LED panel, you need the following:

• HUB75 RGB LED panel
  • Adafruit, Sparkfun, and other distributors carry panels that are known to be compatible with SmartLED Shield and the SmartMatrix library, but most panels on AliExpress and other sources are compatible as well.
  • See more details on HUB75 Panels here
  • An external 5V power supply is required.
• One of the following supported microcontrollers:
  • Teensy 4.0/4.1
  • Teensy 3.2/3.5/3.6/LC
  • ESP32 (experimental support): More info
• SmartLED Shield:
  • SmartLED Shield For Teensy 4
    • More Details and Assembly Instructions
    • Buy SmartLED Shield for Teensy 4
  • SmartLED Shield For Teensy 3
    • More Details and Assembly Instructions
    • Buy SmartLED Shield for Teensy 4
  • Open Source Hardware details for the shields are in the SmartMatrix Library repository under /extras/hardware
  • There's no official SmartLED Shield for ESP32 but you can wire something up yourself, learn about the ESP32 Port

See Installation Instructions in the README doc

Migrating SmartMatrix 3.x Sketches to SmartMatrix 4.0

See MIGRATION doc

More Information

• See Features for a description of the major features of the library.
• See APA102 LEDs for information on connecting APA102 individually addressable LED strips to the SmartLED Shield.
• Troubleshooting
• Documentation for the SmartLED Shield Hardware is hosted on another site: SmartMatrix Docs