Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Nilhcem/keypad-androidthings
Matrix Keypad driver for Android Things
https://github.com/Nilhcem/keypad-androidthings
Last synced: about 2 months ago
JSON representation
Matrix Keypad driver for Android Things
- Host: GitHub
- URL: https://github.com/Nilhcem/keypad-androidthings
- Owner: Nilhcem
- License: apache-2.0
- Created: 2017-07-05T15:20:22.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-05-10T16:48:17.000Z (over 6 years ago)
- Last Synced: 2024-08-01T17:24:35.684Z (5 months ago)
- Language: Java
- Size: 374 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-android-things - keypad - Matrix Keypad (Useful links / Drivers)
- awesome-android-things - keypad - Matrix Keypad (Useful links / Drivers)
README
# Matrix Keypad driver for Android Things
## Download
```groovy
dependencies {
compile 'com.nilhcem.androidthings:driver-keypad:0.0.3'
}
```
## Usage
```java
String[] rowPins = new String[]{"BCM12", "BCM16", "BCM20", "BCM21"};
String[] colPins = new String[]{"BCM25", "BCM24", "BCM23", "BCM27"};
Keypad keypad = new Keypad(rowPins, colPins, Keypad.KEYS_4x4);
// For a 3x4 matrix, you can use the "Keypad.KEYS_3x4" constant. You can also set your own custom keys.
keypad.register(new Keypad.OnKeyEventListener() {
@Override
public void onKeyEvent(KeyEvent keyEvent) {
String action = keyEvent.getAction() == KeyEvent.ACTION_DOWN ? "ACTION_DOWN" : "ACTION_UP";
Log.i(TAG, "onKeyEvent: (" + action + "): " + keyEvent.getDisplayLabel());
}
});
// Don't forget to:
keypad.unregister();
keypad.close();
```
Alternatively, you can register a `KeypadInputDriver` with the system and receive `KeyEvents` through the standard Android APIs:
```java
KeypadInputDriver mInputDriver;
try {
mInputDriver = new KeypadInputDriver(rowPins, colPins, Keypad.KEYS_4x4);
mInputDriver.register();
} catch (IOException e) {
// error configuring keypad...
}
// Override key event callbacks in your Activity:
@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
Log.i(TAG, "onKeyDown: " + event.getDisplayLabel());
return true;
}
@Override
public boolean onKeyUp(int keyCode, KeyEvent event) {
Log.i(TAG, "onKeyUp: " + event.getDisplayLabel());
return true;
}
// Unregister and close the input driver when finished:
mInputDriver.unregister();
try {
mInputDriver.close();
} catch (IOException e) {
// error closing input driver
}
```
Also, don't forget to add the required permission to your app's manifest file:
```xml
```
### Schematic
The sample is for a 4x4 Membrane Matrix Keypad, but the library should work for any keypad formats (e.g. 3x4).
We use 1k pull-up resistors for the rows
![schematic][]
![rowscols][]
* Row 1 -> BCM12
* Row 2 -> BCM16
* Row 3 -> BCM20
* Row 4 -> BCM21
* Col 1 -> BCM25
* Col 2 -> BCM24
* Col 3 -> BCM23
* Col 4 -> BCM27
## Kudos to
* [Polidea][polidea] for the Polithings numpad12 driver.
* [ciromattia][ciromattia] for the Fritzing 4x4 membrane matrix keypad.
[rowscols]: https://raw.githubusercontent.com/Nilhcem/keypad-androidthings/master/assets/rowscols.png
[schematic]: https://raw.githubusercontent.com/Nilhcem/keypad-androidthings/master/assets/schematic.png
[polidea]: https://github.com/Polidea/Polithings/tree/master/numpad
[ciromattia]: https://github.com/ciromattia/Fritzing-Library