Callback button template to call a function if the button is pressed. More...

#include <CallbackButton.h>

Inheritance diagram for able::CallbackButton< Button >:

Public Types
enum	CALLBACK_EVENT { BEGIN_EVENT , PRESSED_EVENT , RELEASED_EVENT , HELD_EVENT , IDLE_EVENT }
	Button event codes. More...

Public Member Functions
	CallbackButton (uint8_t pin, void(*callbackFn)(enum CALLBACK_EVENT, uint8_t)=0, uint8_t id=Pin::nextId())
	Create a callback button on the specified pin. More...

void	begin ()
	Initialise the button. More...

void	handle ()
	Handle the button. More...

void	setCallback (void(*callbackFn)(CALLBACK_EVENT, uint8_t))
	Set a (new) callback function. More...

uint8_t	id () const
	Return the id of the button. More...

bool	resetClicked ()
	Reset the clicked state of the button, returning what is was. More...

bool	resetDoubleClicked ()
	Reset the double-clicked state of the button, returning what is was. More...

bool	isPressed () const
	Determine if the button is currently pressed. More...

bool	isHeld () const
	Determine if the button is currently held down. More...

bool	isIdle () const
	Determine if the button is currently idle (unpressed for a "long" time). More...

bool	isClicked () const
	Determine if the button is clicked. More...

bool	isDoubleClicked () const
	Determine if the button is double-clicked. More...

Protected Member Functions
void	readPin ()
	Read the pin directly. More...

Static Protected Member Functions
static uint8_t	nextId ()
	Return the next auto-assigned button identifier. More...

Protected Attributes
void(*	callbackFn_ )(enum CALLBACK_EVENT, uint8_t)
	Callback function. More...

uint8_t	id_
	Identifier for the button passed to callback functions. More...

bool	longEvent_
	Indicates the held/idle event has been sent. More...

uint8_t	pin_
	The Arduino pin connected to the button. More...

uint8_t	currState_
	The reading of the pin. More...

Static Protected Attributes
static uint8_t	autoId_ = 0
	Auto-assigned button identifier. More...

Detailed Description

template<typename Button>
class able::CallbackButton< Button >

Callback button template to call a function if the button is pressed.

Parameters

Button The base button class for Callback. Defaults to the Button template class.

Definition at line 18 of file CallbackButton.h.

Member Enumeration Documentation

◆ CALLBACK_EVENT

template<typename Button >

enum able::CallbackButton::CALLBACK_EVENT

Button event codes.

When a callback function is called, the first argument is an event code below.

Enumerator
BEGIN_EVENT	The button's begin() method has completed.
PRESSED_EVENT	The button has been pressed.
RELEASED_EVENT	The button has been released.
HELD_EVENT	The button has been held down for a while.
IDLE_EVENT	The button has been idle (untouched) for a while.

Definition at line 24 of file CallbackButton.h.

Constructor & Destructor Documentation

◆ CallbackButton()

template<typename Button >

able::CallbackButton< Button >::CallbackButton	(	uint8_t	pin,
		void(*)(enum CALLBACK_EVENT, uint8_t)	callbackFn = `0`,
		uint8_t	id = `Pin::nextId()`
	)

inline

Create a callback button on the specified pin.

Parameters

pin	The pin connected to the button.
callbackFn	The function to call when the button is pressed.
id	Callback identifier for the button (default auto-assigned).

Definition at line 44 of file CallbackButton.h.

Member Function Documentation

◆ begin()

template<typename Button >

void able::CallbackButton< Button >::begin ( )

inline

Initialise the button.

Called from setup() of an Arduino program.

Definition at line 64 of file CallbackButton.h.

◆ handle()

template<typename Button >

void able::CallbackButton< Button >::handle ( )

inline

Handle the button.

Called from loop() of an Arduino program.

Definition at line 74 of file CallbackButton.h.

◆ id()

template<typename Button >

uint8_t able::CallbackButton< Button >::id ( ) const

inline

Return the id of the button.

Returns: The id of the button (auto-assigned or set when created).

Definition at line 117 of file CallbackButton.h.

◆ isClicked()

template<typename Circuit , typename Pin >

bool able::Button< Circuit, Pin >::isClicked ( ) const

inlineinherited

Determine if the button is clicked.

Clicks are registered as a press then release. If the ClickerPin (or subclass) is used, the button returns the click state, otherwise the compile will fail with errors.

Returns: True if clicked else false.

Definition at line 132 of file Button.h.

◆ isDoubleClicked()

template<typename Circuit , typename Pin >

bool able::Button< Circuit, Pin >::isDoubleClicked ( ) const

inlineinherited

Determine if the button is double-clicked.

Double-clicks are registered as two clicks within the double-click time. If the DoubleClickPin is used, the button returns the double-click state, otherwise the compile will fail with errors.

Returns: True if double-clicked else false.

Definition at line 144 of file Button.h.

◆ isHeld()

template<typename Circuit , typename Pin >

bool able::Button< Circuit, Pin >::isHeld ( ) const

inlineinherited

Determine if the button is currently held down.

Returns: True if held, else false.

Definition at line 112 of file Button.h.

◆ isIdle()

template<typename Circuit , typename Pin >

bool able::Button< Circuit, Pin >::isIdle ( ) const

inlineinherited

Determine if the button is currently idle (unpressed for a "long" time).

Returns: True if idle, else false.

Definition at line 121 of file Button.h.

◆ isPressed()

template<typename Circuit , typename Pin >

bool able::Button< Circuit, Pin >::isPressed ( ) const

inlineinherited

Determine if the button is currently pressed.

Returns: True if pressed, else false.

Definition at line 103 of file Button.h.

◆ nextId()

static uint8_t able::Pin::nextId ( )

inlinestaticprotectedinherited

Return the next auto-assigned button identifier.

Returns: The next auto-assigned button identifier. Each call increases the auto-assigned identifier.

Definition at line 29 of file Pins.h.

◆ readPin()

void able::Pin::readPin ( )

inlineprotectedinherited

Read the pin directly.

In order to save memory, virtual functions are not used (which can consume almost 1K of memory to deal with). Runtime polymorphism is not required, so avoiding virtual functions saves memory.

Definition at line 62 of file Pins.h.

◆ resetClicked()

template<typename Circuit , typename Pin >

bool able::Button< Circuit, Pin >::resetClicked ( )

inlineinherited

Reset the clicked state of the button, returning what is was.

This allows the click state to be effectively read once so that a clicked state only triggers something once, when checked. For example toggling something on/off when the button is clicked. For buttons that don't support clicking, the compile will fail with errors.

Returns: True if the button was clicked, else false.

Definition at line 71 of file Button.h.

◆ resetDoubleClicked()

template<typename Circuit , typename Pin >

bool able::Button< Circuit, Pin >::resetDoubleClicked ( )

inlineinherited

Reset the double-clicked state of the button, returning what is was.

This allows the double-click state to be effectively read once so that a double-clicked state only triggers something once, when checked. For example toggling something on/off when the button is double- clicked. For buttons that don't support double-clicking, the compile will fail with errors.

Returns: True if the button was double-clicked, else false.

Definition at line 87 of file Button.h.

◆ setCallback()

template<typename Button >

void able::CallbackButton< Button >::setCallback ( void(*)(CALLBACK_EVENT, uint8_t) callbackFn )

inline

Set a (new) callback function.

Parameters

callbackFn The function to call for a button event. Use 0 to clear the callback function.

Definition at line 103 of file CallbackButton.h.

Member Data Documentation

◆ autoId_

uint8_t able::Pin::autoId_ = 0

staticprotectedinherited

Auto-assigned button identifier.

Definition at line 70 of file Pins.h.

◆ callbackFn_

template<typename Button >

void(* able::CallbackButton< Button >::callbackFn_) (enum CALLBACK_EVENT, uint8_t)

protected

Callback function.

Definition at line 125 of file CallbackButton.h.

◆ currState_

uint8_t able::Pin::currState_

protectedinherited

The reading of the pin.

Definition at line 73 of file Pins.h.

◆ id_

template<typename Button >

uint8_t able::CallbackButton< Button >::id_

protected

Identifier for the button passed to callback functions.

Definition at line 126 of file CallbackButton.h.

◆ longEvent_

template<typename Button >

bool able::CallbackButton< Button >::longEvent_

protected

Indicates the held/idle event has been sent.

Definition at line 127 of file CallbackButton.h.

◆ pin_

uint8_t able::Pin::pin_

protectedinherited

The Arduino pin connected to the button.

Definition at line 72 of file Pins.h.

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

AbleButtons/src/CallbackButton.h

AbleButtons V0.2.0 Lightweight button library for Arduino.

Public Types

Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ CALLBACK_EVENT

Constructor & Destructor Documentation

◆ CallbackButton()

Member Function Documentation

◆ begin()

◆ handle()

◆ id()

◆ isClicked()

◆ isDoubleClicked()

◆ isHeld()

◆ isIdle()

◆ isPressed()

◆ nextId()

◆ readPin()

◆ resetClicked()

◆ resetDoubleClicked()

◆ setCallback()

Member Data Documentation

◆ autoId_

◆ callbackFn_

◆ currState_

◆ id_

◆ longEvent_

◆ pin_