Skip to content

Latest commit

 

History

History
89 lines (50 loc) · 3.27 KB

README.rst

File metadata and controls

89 lines (50 loc) · 3.27 KB
Raw

This library is used in order to abstract away a few of the details to do with analog multiplexing and demultiplexing. It assumes the following:

  • The multiplexer is analog and is compatible with the 4051 type (ie: 8 analog inputs or outputs, selected by setting HIGH/LOW on 3 digital input pins for 3 bit resolution and an input selection pin active LOW)
  • At this point the library assumes that the IO selector is set high or low by an external method not related to this library. In most instances it's typical to set the component for either input or output not flipping back and forth. This will be resolved in a later version.

See: http://www.arduino.cc/playground/Learning/4051 for more details about the component itself and basic usage. (http://en.wikipedia.org/wiki/Multiplexer for general mux info)

Installation

Download the latest library from it's github repository:

http://github.com/ajfisher/arduino-analog-multiplexer

Next, install the libary in your sketchbook libraries directory:

IE: wherever your sketchbook is (mine's in my home directory in Linux) then in your libraries folder (create it if you don't have it) drop in the analogmuxdemux folder with all files in it.

Using the libary

In a sketch, you can now import the libary using the standard method:

#include <analogmuxdemux.h>

Whether you multiplex or demultiplex the format for instantiating an object is the same. You create a new object of the relevant type and then you pass in the digital output pins that will be used to control which pin is selected on the IC. Alongside this is the pin you would like to use for reading or writing

Multiplexer (for reading):

Create a new instance

AnalogMux amux(int S0, int S1, int S2, int arduino_analog_input);

eg: AnalogMux amux(3, 4, 5, 0);

Reading a specific pin from the IC

int val = amux.AnalogRead(int pin_no);

analogRead() takes the number of the pin to read on the IC (between 0 and 7) and returns a value between 0 and 1023 based on the 8-bit resolution of the Arduino analog input pin.

Demultiplexer (for writing):

Create a new instance

AnalogDeMux demux(int S0, int S1, int S2, int arduino_analog_output);

eg: AnalogDeMux demux(3, 4, 5, 11);

Note that given you are using an ANALOG demux, you'd probably want to make sure you're using a PWM pin so you can use it.

Writing a specific pin to the IC

demux.AnalogWrite(int pin_no, int value);

analogWrite writes a value to the specified pin and can set a value beween 0 and 255 as per normal analog output.

Setting the selection pin for read or write:

Sometimes you might want to set a particular pin on the multiplexer and leave it there for a while for some reason. In this instance you use the selectPin() function.

amux.SelectPin(int pin);

You can then read or write from the multiplexer using simply:

amux.AnalogRead(); or demux.AnalogWrite(value);

With no pin specified.

Example Schematics

Demultiplexer (writing)

  • example-write-schematic.fz (fritzing example)
  • Demux LED (Arduino code example)

TODO:

  • Write examples for analog read and write
  • Make code a little less repetitive
  • Make the code deal with switching between MUX and DEMUX