A MIDI input element that represents a Mackie Control Universal VU meter. More...

#include <MIDI_Inputs/MCU/VU.hpp>

Inheritance diagram for VU_Base< NumValues, Callback >:

Collaboration diagram for VU_Base< NumValues, Callback >:

Public Member Functions
void	begin () override
	Initialize. More...

void	reset () override
	Reset all values to zero. More...

uint8_t	getValue () override
	Return the VU meter value as an integer in [0, 12]. More...

bool	getOverload () override
	Return the overload status. More...

void	update () override
	Update is called periodically, it decays the meter if the time is right. More...

bool	updateWith (const ChannelMessageMatcher &midimsg)
	Receive a new MIDI message and update the internal state. More...

virtual float	getFloatValue ()
	Get the VU meter value as a floating point number. More...

uint8_t	getMax () const
	Get the maximum value that this VU meter can return. More...

Static Public Member Functions
static void	beginAll ()

static void	resetAll ()
	Reset all MIDIInputElementChannelPressure elements to their initial state. More...

static void	updateAll ()
	Update all MIDIInputElementChannelPressure elements. More...

static void	updateAllWith (const ChannelMessageMatcher &midimsg)
	Update all MIDIInputElementChannelPressure elements with a new MIDI message. More...

Public Attributes
Callback	callback

Protected Member Functions
	VU_Base (uint8_t track, const MIDIChannelCN &channelCN, unsigned int decayTime, const Callback &callback)

Protected Attributes
const MIDIAddress	address

MIDIInputElementChannelPressure *	next

MIDIInputElementChannelPressure *	previous

const uint8_t	max

Private Member Functions
bool	updateImpl (const ChannelMessageMatcher &midimsg, const MIDIAddress &target) override
	Called when an incoming MIDI message matches this element. More...

MIDIAddress	getTarget (const ChannelMessageMatcher &midimsg) const override
	The address of the VU meter is the high nibble of the first (and only) data byte. More...

void	decay ()

virtual uint8_t	getSelection () const
	Get the active bank selection. More...

virtual setting_t	getBankIndex (const MIDIAddress &target) const
	Get the bank index from a MIDI address. More...

void	setValue (uint8_t index, uint8_t newValue)
	Set the VU meter value. More...

void	setOverload (uint8_t index)
	Set the overload status. More...

void	clearOverload (uint8_t index)
	Clear the overload status. More...

uint8_t	getValue (uint8_t index) const
	Get the VU meter value from the raw value. More...

bool	getOverload (uint8_t index) const
	Get the overload status value from the raw value. More...

void	moveDown ()
	Move down this element in the linked list of elements. More...

virtual bool	match (const MIDIAddress &target) const
	Check if the address of the incoming MIDI message matches an address of this element. More...

Private Attributes
Array< uint8_t, NumValues >	values = {{}}

unsigned int	decayTime

unsigned long	prevDecayTime = 0

Static Private Attributes
static DoublyLinkedList< MIDIInputElementChannelPressure >	elements

Detailed Description

template<uint8_t NumValues, class Callback>
class MCU::VU_Base< NumValues, Callback >

A MIDI input element that represents a Mackie Control Universal VU meter.

This is a base class to both the Bankable and non-Bankable version.

In the Mackie Control Universal protocol, VU meters are updated using Channel Pressure events.
Each device (cable number) has eight VU meters for the eight tracks. Only MIDI channel 1 is used in the original protocol.

The format of the MIDI message is as follows:
| 1101 cccc | 0hhh llll |

1101 (or 0xD) is the status for Channel Pressure events
cccc is the MIDI channel
hhh is the track index [0-7]
llll is the level of the VU meter

If the level is 0x0, the meter is at 0%, if it's 0xC, the meter is at 100%.
0xD is an invalid value.
0xE sets the overload indicator, and 0xF clears the overload indicator.

Definition at line 78 of file VU.hpp.

Constructor & Destructor Documentation

◆ VU_Base()

VU_Base	(	uint8_t	track,
		const MIDIChannelCN &	channelCN,
		unsigned int	decayTime,
		const Callback &	callback
	)

inlineprotected

Definition at line 80 of file VU.hpp.

Member Function Documentation

◆ begin()

void begin ( )

inlineoverridevirtual

Initialize.

Reimplemented from MIDIInputElement.

Definition at line 87 of file VU.hpp.

◆ reset()

void reset ( )

inlineoverridevirtual

Reset all values to zero.

Reimplemented from MIDIInputElement.

Definition at line 89 of file VU.hpp.

◆ getValue() [1/2]

uint8_t getValue ( )

inlineoverridevirtual

Return the VU meter value as an integer in [0, 12].

Implements IVU.

Definition at line 95 of file VU.hpp.

◆ getOverload() [1/2]

bool getOverload ( )

inlineoverridevirtual

Return the overload status.

Implements IVU.

Definition at line 97 of file VU.hpp.

◆ update()

void update ( )

inlineoverridevirtual

Update is called periodically, it decays the meter if the time is right.

Reimplemented from MIDIInputElement.

Definition at line 100 of file VU.hpp.

◆ updateImpl()

bool updateImpl	(	const ChannelMessageMatcher &	midimsg,
		const MIDIAddress &	target
	)

inlineoverrideprivatevirtual

Called when an incoming MIDI message matches this element.

Implements MIDIInputElement.

Definition at line 110 of file VU.hpp.

◆ getTarget()

MIDIAddress getTarget ( const ChannelMessageMatcher & midimsg ) const

inlineoverrideprivatevirtual

The address of the VU meter is the high nibble of the first (and only) data byte.

Reimplemented from MIDIInputElement.

Definition at line 126 of file VU.hpp.

◆ decay()

void decay ( )

inlineprivate

Definition at line 134 of file VU.hpp.

◆ getSelection()

virtual uint8_t getSelection ( ) const

inlineprivatevirtual

Get the active bank selection.

Reimplemented in GenericVU< NumBanks >, and GenericVU< NumBanks, VULEDsCallback< NumLEDs > >.

Definition at line 141 of file VU.hpp.

◆ getBankIndex()

virtual setting_t getBankIndex ( const MIDIAddress & target ) const

inlineprivatevirtual

Get the bank index from a MIDI address.

Reimplemented in GenericVU< NumBanks, Callback >, GenericVU< NumBanks >, and GenericVU< NumBanks, VULEDsCallback< NumLEDs > >.

Definition at line 144 of file VU.hpp.

◆ setValue()

void setValue	(	uint8_t	index,
		uint8_t	newValue
	)

inlineprivate

Set the VU meter value.

Definition at line 150 of file VU.hpp.

◆ setOverload()

void setOverload ( uint8_t index )

inlineprivate

Set the overload status.

Definition at line 156 of file VU.hpp.

◆ clearOverload()

void clearOverload ( uint8_t index )

inlineprivate

Clear the overload status.

Definition at line 158 of file VU.hpp.

◆ getValue() [2/2]

uint8_t getValue ( uint8_t index ) const

inlineprivate

Get the VU meter value from the raw value.

Definition at line 160 of file VU.hpp.

◆ getOverload() [2/2]

bool getOverload ( uint8_t index ) const

inlineprivate

Get the overload status value from the raw value.

Definition at line 162 of file VU.hpp.

◆ beginAll()

static void beginAll ( )

inlinestaticinherited

Definition at line 44 of file MIDIInputElementChannelPressure.hpp.

◆ resetAll()

static void resetAll ( )

inlinestaticinherited

Reset all MIDIInputElementChannelPressure elements to their initial state.

See also: MIDIInputElementChannelPressure::reset

Definition at line 56 of file MIDIInputElementChannelPressure.hpp.

◆ updateAll()

static void updateAll ( )

inlinestaticinherited

Update all MIDIInputElementChannelPressure elements.

Definition at line 65 of file MIDIInputElementChannelPressure.hpp.

◆ updateAllWith()

static void updateAllWith ( const ChannelMessageMatcher & midimsg )

inlinestaticinherited

Update all MIDIInputElementChannelPressure elements with a new MIDI message.

See also: MIDIInputElementChannelPressure::updateWith

Definition at line 77 of file MIDIInputElementChannelPressure.hpp.

◆ moveDown()

void moveDown ( )

inlineprivateinherited

Move down this element in the linked list of elements.

This means that the element will be checked earlier on the next iteration.

Definition at line 105 of file MIDIInputElementChannelPressure.hpp.

◆ updateWith()

bool updateWith ( const ChannelMessageMatcher & midimsg )

inlineinherited

Receive a new MIDI message and update the internal state.

Definition at line 39 of file MIDIInputElement.hpp.

◆ match()

virtual bool match ( const MIDIAddress & target ) const

inlineprivatevirtualinherited

Check if the address of the incoming MIDI message matches an address of this element.

Note: This base version of the function is only valid for non-Bankable MIDI input elements, it only matches if the address is equal to the address of this element.

Definition at line 78 of file MIDIInputElement.hpp.

◆ getFloatValue()

virtual float getFloatValue ( )

inlinevirtualinherited

Get the VU meter value as a floating point number.

Reimplemented in AudioVU.

Definition at line 28 of file VU.hpp.

◆ getMax()

uint8_t getMax ( ) const

inlineinherited

Get the maximum value that this VU meter can return.

Definition at line 30 of file VU.hpp.

Member Data Documentation

◆ values

Array<uint8_t, NumValues> values = {{}}

private

Definition at line 165 of file VU.hpp.

◆ decayTime

unsigned int decayTime

private

Definition at line 166 of file VU.hpp.

◆ prevDecayTime

unsigned long prevDecayTime = 0

private

Definition at line 167 of file VU.hpp.

◆ callback

Callback callback

Definition at line 170 of file VU.hpp.

◆ elements

DoublyLinkedList< MIDIInputElementChannelPressure > elements

staticprivateinherited

Definition at line 110 of file MIDIInputElementChannelPressure.hpp.

◆ address

const MIDIAddress address

protectedinherited

Definition at line 83 of file MIDIInputElement.hpp.

◆ next

MIDIInputElementChannelPressure * next

protectedinherited

Definition at line 323 of file LinkedList.hpp.

◆ previous

MIDIInputElementChannelPressure * previous

protectedinherited

Definition at line 324 of file LinkedList.hpp.

◆ max

const uint8_t max

protectedinherited

Definition at line 33 of file VU.hpp.

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

VU.hpp

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

template<uint8_t NumValues, class Callback> class MCU::VU_Base< NumValues, Callback >

Constructor & Destructor Documentation

◆ VU_Base()

Member Function Documentation

◆ begin()

◆ reset()

◆ getValue() [1/2]

◆ getOverload() [1/2]

◆ update()

◆ updateImpl()

◆ getTarget()

◆ decay()

◆ getSelection()

◆ getBankIndex()

◆ setValue()

◆ setOverload()

◆ clearOverload()

◆ getValue() [2/2]

◆ getOverload() [2/2]

◆ beginAll()

◆ resetAll()

◆ updateAll()

◆ updateAllWith()

◆ moveDown()

◆ updateWith()

◆ match()

◆ getFloatValue()

◆ getMax()

Member Data Documentation

◆ values

◆ decayTime

◆ prevDecayTime

◆ callback

◆ elements

◆ address

◆ next

◆ previous

◆ max

template<uint8_t NumValues, class Callback>
class MCU::VU_Base< NumValues, Callback >