Arduino, ESP8266 and STM32 multiplexed outputs library - uMuxOutputLib

Master status:

What is this repository for?

Really tiny library to control multiplexed outputs.

It cycles among multiplexed outputs using a timer to control all pins.

Important: Dependencies

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

https://github.com/Naguissa/uTimerLib https://github.com/Naguissa/uTimerLib/releases

How do I get set up?

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

For manual installation:

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

Documentation and extras

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

You can read documentation online here: https://naguissa.github.io/uMuxOutputLib_doc_and_extras/

Usage

Constructor:

uMuxOutputLib::uMuxOutputLib(uint8_t npins, uint8_t nmuxes, int *pins, int *muxes, unsigned int freq);

Parameters:

• npins: number of real pins, excluding muxes
• nmuxes: number of muxes pins
• pins: Array of all real pins, excluding muxes.
• muxes: Array of pins used to multiplex real pins.
• freq: Optional. Desired refresh frequency. Default is 70 (Hz). This frequency will be multiplied by number of muxes.

Set a value:

void uMuxOutputLib::setPinAbsolute(uint position, bool value);

Parameters:

• position: Position of the bit on linear fashion
• value: Value to be set

void uMuxOutputLib::setPinMuxPin(uint8_t pin, uint8_t mux, bool value);

Parameters:

• pin: Pin position on passed pins array (starting at 0)
• mux: Mux position on passed muxes array (starting at 0)
• value: Value to be set

Start library

void uMuxOutputLib::attachInterrupt();

Attaches internal timer interrupts to run multiplexed pins.

Extra: Mux logic level

bool uSevenSegmentLib::activeMuxValue = false;

This variable is used to indicate the level of an active mux. All muxes will be set to inverse of this value when they are not active.

Typical usage:

• You instantiate an object (usually a global scope object): uMuxOutputLib muxed(nPins, nMuxes, pinsArray, muxesArray);
• Then set any initial value on it on setup(): muxed.set(position, bool_value); or muxed.set(pin, mux, bool_value);
• And attach interrupts to start working (still on setup()): muxed.attachInterrupt();
• Then, wherever you want, you can change displayed values at your will using same methods as 2nd step.

Examples

Included on example folder, available on Arduino IDE.

• 6 leds cycling, connected using 3 real pins and 2 muxed pins

Who do I talk to?

• Naguissa
• https://www.foroelectro.net/librerias-arduino-ide-f29/umuxoutputlib-libreria-arduino-para-controlar-mult-t293.html
• https://www.naguissa.com

Contribute

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/uMuxOutputLib
• You can make a donation via PayPal: https://paypal.me/foroelectro

Thanks for your support.

Contributors hall of fame: https://www.foroelectro.net/hall-of-fame-f32/contributors-contribuyentes-t271.html