#include <AH/Hardware/ExtendedInputOutput/AnalogMultiplex.hpp>

Detailed Description

template<uint8_t N>
class AnalogMultiplex< N >

A class for reading multiplexed analog inputs.

Supports 74HC4067, 74HC4051, etc.

You can use many multiplexers on the same address lines if each of the multiplexers has a different enable line.

Template Parameters

N	The number of address lines.

Examples: 1.AnalogReadSerial.ino, 2.DigitalReadSerial.ino, 3.FilteredAnalogReadSerial.ino, and Toggle-LEDs.ino.

Definition at line 25 of file AnalogMultiplex.hpp.

Inheritance diagram for AnalogMultiplex< N >:

Collaboration diagram for AnalogMultiplex< N >:

Public Member Functions
	AnalogMultiplex (pin_t analogPin, const Array< pin_t, N > &addressPins, pin_t enablePin=NO_PIN)
	Create a new AnalogMultiplex object on the given pins. More...

void	pinMode (pin_t pin, PinMode_t mode) override
	Set the pin mode of the analog input pin. More...

void	pinModeBuffered (pin_t pin, PinMode_t mode) override
	Set the pin mode of the analog input pin. More...

void	digitalWrite (pin_t, PinStatus_t) override __attribute__((deprecated))
	The digitalWrite function is not implemented because writing an output to a multiplexer is not useful. More...

void	digitalWriteBuffered (pin_t, PinStatus_t) override __attribute__((deprecated))
	The digitalWrite function is not implemented because writing an output to a multiplexer is not useful. More...

PinStatus_t	digitalRead (pin_t pin) override
	Read the digital state of the given input. More...

PinStatus_t	digitalReadBuffered (pin_t pin) override
	Read the digital state of the given input. More...

analog_t	analogRead (pin_t pin) override
	Read the analog value of the given input. More...

analog_t	analogReadBuffered (pin_t pin) override
	Read the analog value of the given input. More...

void	analogWrite (pin_t, analog_t) override __attribute__((deprecated))
	The analogWrite function is not implemented because writing an output to a multiplexer is not useful. More...

void	analogWriteBuffered (pin_t, analog_t) override __attribute__((deprecated))
	The analogWrite function is not implemented because writing an output to a multiplexer is not useful. More...

void	begin () override
	Initialize the multiplexer: set the pin mode of the address pins and the enable pin to output mode. More...

void	updateBufferedOutputs () override
	No periodic updating of the state is necessary, all actions are carried out when the user calls analogRead or digitalRead. More...

void	updateBufferedInputs () override
	No periodic updating of the state is necessary, all actions are carried out when the user calls analogRead or digitalRead. More...

void	discardFirstReading (bool discardFirstReading_)
	Specify whether to discard the first analog reading after changing the address lines (enabled by default). More...

Protected Member Functions
void	setMuxAddress (uint8_t address)
	Write the pin number/address to the address pins of the multiplexer. More...

void	prepareReading (uint8_t address)
	Select the correct address and enable the multiplexer. More...

void	afterReading ()
	Disable the multiplexer. More...

Protected Attributes
const pin_t	analogPin

const Array< pin_t, N >	addressPins

const pin_t	enablePin

bool	discardFirstReading_ = true

Static Protected Attributes
static constexpr auto	MUX_ENABLED = LOW

static constexpr auto	MUX_DISABLED = HIGH

Constructor & Destructor Documentation

◆ AnalogMultiplex()

AnalogMultiplex	(	pin_t	analogPin,
		const Array< pin_t, N > &	addressPins,
		pin_t	enablePin = `NO_PIN`
	)

inline

Create a new AnalogMultiplex object on the given pins.

Parameters

analogPin	The analog input pin connected to the output of the multiplexer.
addressPins	An array of the pins connected to the address lines of the multiplexer. (Labeled S0, S1, S2 ... in the datasheet.)
enablePin	The digital output pin connected to the enable pin of the multiplexer. (Labeled Ē in the datasheet.) If you don't need the enable pin, you can use NO_PIN, which is the default.

Definition at line 41 of file AnalogMultiplex.hpp.

Member Function Documentation

◆ pinMode()

void pinMode	(	pin_t	pin,
		PinMode_t	mode
	)

override

Set the pin mode of the analog input pin.

This allows you to enable the internal pull-up resistor, for use with buttons or open-collector outputs.

Note: This applies to all pins of this multiplexer.
This affects all pins of the multiplexer, because it has only a single common pin.

Parameters

pin	(Unused)
mode	The new mode of the input pin: either INPUT or INPUT_PULLUP.

Definition at line 198 of file AnalogMultiplex.hpp.

◆ pinModeBuffered()

void pinModeBuffered	(	pin_t	pin,
		PinMode_t	mode
	)

override

Set the pin mode of the analog input pin.

This allows you to enable the internal pull-up resistor, for use with buttons or open-collector outputs.

Note: This applies to all pins of this multiplexer.
This affects all pins of the multiplexer, because it has only a single common pin.

Parameters

pin	(Unused)
mode	The new mode of the input pin: either INPUT or INPUT_PULLUP.

Definition at line 203 of file AnalogMultiplex.hpp.

◆ digitalWrite()

void digitalWrite	(	pin_t	,
		PinStatus_t
	)

inlineoverride

The digitalWrite function is not implemented because writing an output to a multiplexer is not useful.

Definition at line 72 of file AnalogMultiplex.hpp.

◆ digitalWriteBuffered()

void digitalWriteBuffered	(	pin_t	,
		PinStatus_t
	)

inlineoverride

The digitalWrite function is not implemented because writing an output to a multiplexer is not useful.

Definition at line 78 of file AnalogMultiplex.hpp.

◆ digitalRead()

PinStatus_t digitalRead ( pin_t pin )

override

Read the digital state of the given input.

Parameters

pin	The multiplexer's pin number to read from.

Definition at line 208 of file AnalogMultiplex.hpp.

◆ digitalReadBuffered()

PinStatus_t digitalReadBuffered ( pin_t pin )

override

Read the digital state of the given input.

Parameters

pin	The multiplexer's pin number to read from.

Definition at line 216 of file AnalogMultiplex.hpp.

◆ analogRead()

analog_t analogRead ( pin_t pin )

override

Read the analog value of the given input.

Parameters

pin	The multiplexer's pin number to read from.

Definition at line 221 of file AnalogMultiplex.hpp.

◆ analogReadBuffered()

analog_t analogReadBuffered ( pin_t pin )

override

Read the analog value of the given input.

Parameters

pin	The multiplexer's pin number to read from.

Definition at line 231 of file AnalogMultiplex.hpp.

◆ analogWrite()

void analogWrite	(	pin_t	,
		analog_t
	)

inlineoverride

The analogWrite function is not implemented because writing an output to a multiplexer is not useful.

Definition at line 111 of file AnalogMultiplex.hpp.

◆ analogWriteBuffered()

void analogWriteBuffered	(	pin_t	,
		analog_t
	)

inlineoverride

The analogWrite function is not implemented because writing an output to a multiplexer is not useful.

Definition at line 117 of file AnalogMultiplex.hpp.

◆ begin()

void begin

override

Initialize the multiplexer: set the pin mode of the address pins and the enable pin to output mode.

Examples: 1.AnalogReadSerial.ino, 2.DigitalReadSerial.ino, and 3.FilteredAnalogReadSerial.ino.

Definition at line 236 of file AnalogMultiplex.hpp.

◆ updateBufferedOutputs()

void updateBufferedOutputs ( )

inlineoverride

No periodic updating of the state is necessary, all actions are carried out when the user calls analogRead or digitalRead.

Definition at line 130 of file AnalogMultiplex.hpp.

◆ updateBufferedInputs()

void updateBufferedInputs ( )

inlineoverride

No periodic updating of the state is necessary, all actions are carried out when the user calls analogRead or digitalRead.

Definition at line 136 of file AnalogMultiplex.hpp.

◆ discardFirstReading()

void discardFirstReading ( bool discardFirstReading_ )

inline

Specify whether to discard the first analog reading after changing the address lines (enabled by default).

Definition at line 142 of file AnalogMultiplex.hpp.

◆ setMuxAddress()

void setMuxAddress ( uint8_t address )

protected

Write the pin number/address to the address pins of the multiplexer.

Parameters

address The address to select.

Definition at line 246 of file AnalogMultiplex.hpp.

◆ prepareReading()

void prepareReading ( uint8_t address )

protected

Select the correct address and enable the multiplexer.

Parameters

address The address to select.

Definition at line 258 of file AnalogMultiplex.hpp.

◆ afterReading()

void afterReading

protected

Disable the multiplexer.

Definition at line 265 of file AnalogMultiplex.hpp.

Member Data Documentation

◆ analogPin

const pin_t analogPin

protected

Definition at line 147 of file AnalogMultiplex.hpp.

◆ addressPins

const Array<pin_t, N> addressPins

protected

Definition at line 148 of file AnalogMultiplex.hpp.

◆ enablePin

const pin_t enablePin

protected

Definition at line 149 of file AnalogMultiplex.hpp.

◆ discardFirstReading_

bool discardFirstReading_ = true

protected

Definition at line 150 of file AnalogMultiplex.hpp.

◆ MUX_ENABLED

constexpr auto MUX_ENABLED = LOW

staticconstexprprotected

Definition at line 175 of file AnalogMultiplex.hpp.

◆ MUX_DISABLED

constexpr auto MUX_DISABLED = HIGH

staticconstexprprotected

Definition at line 176 of file AnalogMultiplex.hpp.

The documentation for this class was generated from the following file:

AnalogMultiplex.hpp

Detailed Description

Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Constructor & Destructor Documentation

◆ AnalogMultiplex()

Member Function Documentation

◆ pinMode()

◆ pinModeBuffered()

◆ digitalWrite()

◆ digitalWriteBuffered()

◆ digitalRead()

◆ digitalReadBuffered()

◆ analogRead()

◆ analogReadBuffered()

◆ analogWrite()

◆ analogWriteBuffered()

◆ begin()

◆ updateBufferedOutputs()

◆ updateBufferedInputs()

◆ discardFirstReading()

◆ setMuxAddress()

◆ prepareReading()

◆ afterReading()

Member Data Documentation

◆ analogPin

◆ addressPins

◆ enablePin

◆ discardFirstReading_

◆ MUX_ENABLED

◆ MUX_DISABLED