mirror of
https://github.com/RobTillaart/Arduino.git
synced 2024-10-03 18:09:02 -04:00
70 lines
1.9 KiB
Markdown
70 lines
1.9 KiB
Markdown
|
|
[](https://github.com/marketplace/actions/arduino_ci)
|
|
|
|
[](https://github.com/RobTillaart/AnalogKeypad/blob/master/LICENSE)
|
|
[](https://github.com/RobTillaart/AnalogKeypad/releases)
|
|
|
|
|
|
# AnalogKeypad
|
|
|
|
Library for (Robotdyn) 4x4 and 4x3 analog keypad
|
|
|
|
|
|
## Description
|
|
|
|
AnalogKeypad is a simple library to read the keys from a (robotdyn) 4x4 or 4x3 keypad.
|
|
No other keypads are tested, but they should work with this library after adjusting
|
|
the **MAGIC NUMBERS** in the function **rawRead()**.
|
|
|
|
|
|
## Interface
|
|
|
|
|
|
### Constructor
|
|
|
|
- **AnalogKeypad(const uint8_t pin, const uint8_t bits = 10)** constructor, pin is typical A0 etc
|
|
Bits has a default of 10, but need to be set to match the platform.
|
|
|
|
|
|
### polling interface
|
|
|
|
- **uint8_t pressed()** returns 0 if no key pressed, otherwise returns key pressed (may fluctuate)
|
|
- **uint8_t read()** read the key pressed returns 0..16
|
|
|
|
|
|
### event interface
|
|
|
|
- **uint8_t event()** checks if a change has occurred since last time.
|
|
- **uint8_t key()** returns the key involved with last event
|
|
|
|
Switch(int e = event())
|
|
|
|
| Event | value |
|
|
|:--------:|:-----:|
|
|
| PRESSED | 0x80 |
|
|
| RELEASED | 0x40 |
|
|
| REPEATED | 0x20 |
|
|
| CHANGED | 0x10 |
|
|
| NOKEY | 0x00 |
|
|
|
|
|
|
## Operation
|
|
|
|
The simplest usage is to use the **read()** function.
|
|
This will return a 0 (NOKEY) when no key is pressed and
|
|
a number 1 to 16 for the keys pressed. Note the return value may
|
|
fluctuate randomly when multiple keys are pressed.
|
|
|
|
The **pressed()** function is a bit more robust.
|
|
It returns the key pressed first, so multiple key presses simultaniously
|
|
are less likely to disturbe your program.
|
|
|
|
See Examples
|
|
|
|
## Future
|
|
|
|
- more examples
|
|
- self-learning example?
|
|
|
|
|