#include <MIDI_Outputs/ManyAddresses/CCButtonMatrix.hpp>
A class of MIDIOutputElements that read the input from a matrix of momentary push buttons or switches, and send out MIDI Control Change events.
A value of 0x7F is sent when a button is pressed, and a value of 0x00 is sent when a button is released.
Crude software debouncing is implemented by limiting the refresh rate.
NumBanks | The number of variants/alternative addresses the element has. |
NumRows | The number of rows of the matrix. |
NumCols | The number of columns of the matrix. |
Definition at line 34 of file ManyAddresses/CCButtonMatrix.hpp.
Enabling and disabling updatables | |
void | enable () |
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically. | |
void | disable () |
Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically. | |
bool | isEnabled () const |
Check if this updatable is enabled. | |
void | moveDown () |
Move down this element in the list. | |
static void | enable (UpdatableCRTP *element) |
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically. | |
static void | enable (UpdatableCRTP &element) |
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically. | |
template<class U , size_t N> | |
static void | enable (U(&array)[N]) |
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically. | |
static void | disable (UpdatableCRTP *element) |
Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically. | |
static void | disable (UpdatableCRTP &element) |
Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically. | |
template<class U , size_t N> | |
static void | disable (U(&array)[N]) |
Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically. | |
Main initialization and updating methods | |
static void | beginAll () |
Begin all enabled instances of this class. | |
static void | updateAll () |
Update all enabled instances of this class. | |
Public Member Functions | |
CCButtonMatrix (const Bank< NumBanks > &bank, const PinList< NumRows > &rowPins, const PinList< NumCols > &colPins, const Array< AddressMatrix< NumRows, NumCols >, NumBanks > &controllers, const Array< MIDIChannelCable, NumBanks > &channelCNs, const DigitalCCSender &sender={}) | |
Create a new Bankable CCButtonMatrix object with the given pins, controller numbers and channel. | |
void | begin () override |
Initialize this updatable. | |
void | update () override |
Update this updatable. | |
bool | getPrevState (uint8_t col, uint8_t row) |
Get the state of the button in the given column and row. | |
void | setDebounceTime (unsigned long debounceTime) |
Configure the debounce time interval. | |
unsigned long | getDebounceTime () const |
Get the debounce time. | |
Public Attributes | |
DigitalCCSender | sender |
Protected Attributes | |
ManyMatrixAddresses< NumBanks, NumRows, NumCols > | address |
uint16_t | activeButtons |
Derived * | next |
Derived * | previous |
Static Protected Attributes | |
static DoublyLinkedList< Derived > | updatables |
Private Types | |
using | ButtonMatrix |
Private Member Functions | |
void | onButtonChanged (uint8_t row, uint8_t col, bool state) |
void | setPrevState (uint8_t col, uint8_t row, bool state) |
Static Private Member Functions | |
static uint8_t | positionToBits (uint8_t col, uint8_t row) |
static uint8_t | bitsToIndex (uint8_t bits) |
static uint8_t | bitsToBitmask (uint8_t bits) |
Private Attributes | |
unsigned long | debounceTime = BUTTON_DEBOUNCE_TIME |
unsigned long | prevRefresh = 0 |
uint8_t | prevStates [(NumCols *NumRows+7)/8] |
const PinList< NumRows > | rowPins |
const PinList< NumCols > | colPins |
|
privateinherited |
Definition at line 34 of file Bankable/Abstract/MIDIButtonMatrix.hpp.
|
inline |
Create a new Bankable CCButtonMatrix object with the given pins, controller numbers and channel.
bank | The bank to add this element to. |
rowPins | A list of pin numbers connected to the rows of the button matrix. ⚠ These pins will be driven LOW as outputs (Lo-Z). |
colPins | A list of pin numbers connected to the columns of the button matrix. These pins will be used as inputs (Hi-Z), and the internal pull-up resistor will be enabled. |
controllers | A list of 2-dimensional arrays of the same dimensions as the button matrix that contains the MIDI Controller number of each button. [0, 119] |
channelCNs | The a list containing the MIDI channels [Channel_1, Channel_16] and Cable Numbers [Cable_1, Cable_16]. |
sender | The MIDI sender to use. |
Definition at line 64 of file ManyAddresses/CCButtonMatrix.hpp.
|
inlineoverridevirtualinherited |
Initialize this updatable.
Implements Updatable< T >.
Definition at line 61 of file Bankable/Abstract/MIDIButtonMatrix.hpp.
|
inlineoverridevirtualinherited |
Update this updatable.
Implements Updatable< T >.
Definition at line 63 of file Bankable/Abstract/MIDIButtonMatrix.hpp.
Definition at line 66 of file Bankable/Abstract/MIDIButtonMatrix.hpp.
Begin all enabled instances of this class.
Definition at line 182 of file Updatable.hpp.
Update all enabled instances of this class.
Definition at line 186 of file Updatable.hpp.
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically.
Definition at line 96 of file Updatable.hpp.
|
inlinestaticinherited |
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically.
Definition at line 125 of file Updatable.hpp.
|
inlinestaticinherited |
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically.
Definition at line 127 of file Updatable.hpp.
Enable this updatable: insert it into the linked list of instances, so it gets updated automatically.
Definition at line 130 of file Updatable.hpp.
Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically.
Definition at line 106 of file Updatable.hpp.
|
inlinestaticinherited |
Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically.
Definition at line 136 of file Updatable.hpp.
|
inlinestaticinherited |
Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically.
Definition at line 138 of file Updatable.hpp.
Disable this updatable: remove it from the linked list of instances, so it no longer gets updated automatically.
Definition at line 141 of file Updatable.hpp.
Check if this updatable is enabled.
Definition at line 120 of file Updatable.hpp.
Move down this element in the list.
Definition at line 147 of file Updatable.hpp.
Get the state of the button in the given column and row.
Configure the debounce time interval.
Only one button can change in each debounce interval. Time in milliseconds.
Definition at line 58 of file ButtonMatrix.hpp.
Get the debounce time.
Definition at line 62 of file ButtonMatrix.hpp.
|
protectedinherited |
Definition at line 81 of file Bankable/Abstract/MIDIButtonMatrix.hpp.
|
protectedinherited |
Definition at line 82 of file Bankable/Abstract/MIDIButtonMatrix.hpp.
|
inherited |
Definition at line 85 of file Bankable/Abstract/MIDIButtonMatrix.hpp.
|
staticprotectedinherited |
Definition at line 152 of file Updatable.hpp.
|
protectedinherited |
Definition at line 320 of file LinkedList.hpp.
|
protectedinherited |
Definition at line 321 of file LinkedList.hpp.
|
privateinherited |
Definition at line 84 of file ButtonMatrix.hpp.
Definition at line 85 of file ButtonMatrix.hpp.
Definition at line 86 of file ButtonMatrix.hpp.
Definition at line 88 of file ButtonMatrix.hpp.
Definition at line 89 of file ButtonMatrix.hpp.