72 lines
1.4 KiB
C
Raw Normal View History

2021-01-29 12:31:58 +01:00
#pragma once
//
// FILE: I2CKeyPad.h
// AUTHOR: Rob Tillaart
2023-11-11 17:08:08 +01:00
// VERSION: 0.4.0
2021-11-08 13:13:29 +01:00
// PURPOSE: Arduino library for 4x4 KeyPad connected to an I2C PCF8574
2021-01-29 12:31:58 +01:00
// URL: https://github.com/RobTillaart/I2CKeyPad
2021-11-08 13:13:29 +01:00
2021-01-29 12:31:58 +01:00
#include "Arduino.h"
#include "Wire.h"
2021-11-08 13:13:29 +01:00
2023-11-11 17:08:08 +01:00
#define I2C_KEYPAD_LIB_VERSION (F("0.4.0"))
2021-01-29 12:31:58 +01:00
#define I2C_KEYPAD_NOKEY 16
#define I2C_KEYPAD_FAIL 17
2022-09-29 16:17:30 +02:00
// experimental
#define I2C_KEYPAD_4x4 44
#define I2C_KEYPAD_5x3 53
#define I2C_KEYPAD_6x2 62
#define I2C_KEYPAD_8x1 81
2021-11-08 13:13:29 +01:00
2021-01-29 12:31:58 +01:00
class I2CKeyPad
{
public:
2021-05-08 09:52:18 +02:00
I2CKeyPad(const uint8_t deviceAddress, TwoWire *wire = &Wire);
2021-01-29 12:31:58 +01:00
2023-11-11 17:08:08 +01:00
// call Wire.begin() first!
2021-05-08 09:52:18 +02:00
bool begin();
2021-11-08 13:13:29 +01:00
2021-12-19 20:23:20 +01:00
// get raw key's 0..15
2021-01-29 12:31:58 +01:00
uint8_t getKey();
2022-09-29 16:17:30 +02:00
uint8_t getLastKey();
2021-11-08 13:13:29 +01:00
2022-09-29 16:17:30 +02:00
bool isPressed();
2021-01-29 12:31:58 +01:00
bool isConnected();
2021-12-19 20:23:20 +01:00
// get 'translated' keys
2022-09-29 16:17:30 +02:00
// user must load KeyMap, there is no check.
uint8_t getChar();
uint8_t getLastChar();
void loadKeyMap(char * keyMap); // char[19]
// mode functions - experimental
void setKeyPadMode(uint8_t mode = I2C_KEYPAD_4x4);
uint8_t getKeyPadMode();
2021-11-08 13:13:29 +01:00
2021-12-19 20:23:20 +01:00
2021-11-08 13:13:29 +01:00
protected:
2021-01-29 12:31:58 +01:00
uint8_t _address;
uint8_t _lastKey;
2022-09-29 16:17:30 +02:00
uint8_t _mode;
2021-01-29 12:31:58 +01:00
uint8_t _read(uint8_t mask);
2021-11-08 13:13:29 +01:00
uint8_t _getKey4x4();
2022-09-29 16:17:30 +02:00
// experimental - could be public ?!
uint8_t _getKey5x3();
uint8_t _getKey6x2();
uint8_t _getKey8x1();
2021-05-08 09:52:18 +02:00
TwoWire* _wire;
2022-09-29 16:17:30 +02:00
2021-11-08 13:13:29 +01:00
char * _keyMap = NULL;
2021-01-29 12:31:58 +01:00
};
2021-11-08 13:13:29 +01:00
2023-11-11 17:08:08 +01:00
// -- END OF FILE --
2021-11-08 13:13:29 +01:00