General Information

LedController is an Arduino library for MAX7219 and MAX7221 Led display drivers. It can handle 7-Segment displays and Led Matricies. As of version 2.0.0 it supports having multiple rows and movement functions if you use it to control LED Matricies.

The code was forked from the LedControl library which has not received any updates for many years but the supported features are now well beyond the original library.

You can find the repository here. Feel free to propose new features or report any bugs you have found. Please mention the version of the LedController you have encountered the bug in. If you have questions with using the library please open a new discussion.

Version 2.0.0 is out now. It comes with a lot of changes so please refer to the documentation to see how to migrate to version 2.0.x.

  • This image shows how the Led-matrix-counting example can look like.

Future Plans

Some of the features planned for the next versions are listed below.

Version 2.1.0 will have better support for 7-Segment Displays and have better compatibility. All of the Arduino code will be abstracted (including the SPI code) to make it easy to port the LedController to other platforms like raspberry pi or some risc-v boards. This is done by using my generic-Arduino library, which implements the core Arduino functions, if they are not available on a given platform. The movement functions will be implemented for 7-Segment Displays.

Version 2.2.0 will become more modular which allows smaller programs when some features are not needed. I might also explore the idea to have an implementation as a C++20 module but that will probably not work with most boards since they use old compilers (a lot of them only support up to C++14 and not a single STD header which is stupid).


Once I have written and recorded some tutorials they will be linked below. Please note that they will be patreon exclusive before they go public.

Leave a comment