Home

SmartMatrix Wiki

This Wiki is intended to be the future home of documentation for the upcoming SmartMatrix 4.0 release. For now, this serves as a place to document the teensy4 branch and keep track of documentation to-do items. If a feature is listed as being included in SmartMatrix 4.0, and SmartMatrix 4.0 hasn't been released yet, look for it in the teensy4 branch.

SmartMatrix is a library that makes it easy to display graphics and scrolling text on RGB LED matrix panels (sometimes called "HUB75") using a Teensy or ESP32 microcontroller. The newest branch of the library can be found here.

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.
  • 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)
• SmartLED Shield:
  • SmartLED Shield For Teensy 4 is coming soon.
  • SmartLED Shield For Teensy 3 is available from several distributors. This shield can be used with Teensy 4.0/4.1 using a special adapter.
  • See here for ESP32 wiring.

See Installation for step-by-step instructions to get the library installed, and see Examples to run the demos.

More Information

• See Features for a description of the major features of the library.
• See Hardware for the differences in support for different boards.
• See APA102 for information on connecting APA102 individually addressable LED strips to the SmartLED Shield.
• Troubleshooting