Arduino, ESP8266 and STM32 7-segment multiplexed displays library - uSevenSegmentLib

Master status:

What is this repository for?

Really tiny library to control multiplexed basic 7 segments displays.

It can work with only a display but it's intended to use more than one and drive them multiplexed.

If you want to use only one display you can do it without flickering, without using timers and using less code driving it directly.

This library requires uTimerLib libary; it's available on IDE Library Manager and also here:

You can get it from Arduino libraries directly, searching by uSevenSegmentLib.

For manual installation:

Get the ZIP from releases link: https://github.com/Naguissa/uSevenSegmentLib/releases
Rename to uSevenSegmentLib.zip
Install library on Arduino

You can find all documentation and extras in this repository: https://github.com/Naguissa/uSevenSegmentLib_doc_and_extras

Important: Remember to add resistors as needed, depending on your MCU voltage.

uSevenSegmentLib::uSevenSegmentLib(unsigned char displays, int pins[8], int *muxes, unsigned int freq, bool common_anode);

Parameters:

displays: number of displays (7-segment modules)
pins: Array of all pins of the displays in {a, b, c, d, e, f, g, h} form. See extras folder for details.
muxes: Array of common anode/cathode, one by each display. Used to multiplex the displays.
freq: Optional. Desired refresh frequency. Default is 40 (Hz). This frequency will be multiplied by number of displays, so it's a "all displays" refresh rate.
common_anode: Optional. Set to true if you are using common_anode displays.

void uSevenSegmentLib::set(long int number);

Parameters:

void uSevenSegmentLib::attachInterrupt();

Attaches internal timer interrupts to run multiplexed displays.

void uSevenSegmentLib::zeroFill(bool zf);

Parameters:

You instantiate an object (usually a global scope object): uSevenSegmentLib sevenSegments(3, pins, muxes);
Then set any initial value on it on setup(): sevenSegments.set(0);
And attach interrupts to start working (still on setup()): sevenSegments.attachInterrupt();
Then, wherever you want, you can change displayed values at your will: sevenSegments.set(77);

Included on example folder, available on Arduino IDE.

Three 7-segments counter example, that counts from 0 to 255.
One example to test connections to a 7-segment module; lights sequently from "a" to "h" segments. This example doesn't use library functions.

Look in extras folder for a typical pinout and

Any code contribution, report or comment are always welcome. Don't hesitate to use GitHub for that.

You can sponsor this project using GitHub's Sponsor button: https://github.com/Naguissa/uSevenSegmentLib
You can make a donation via PayPal: https://paypal.me/foroelectro

Thanks for your support.