Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alankrantas/micropython-TTP229-BSF
MicroPython ESP8266/ESP32 driver for TTP229-BSF 16-key capacitive keypad in serial interface mode
https://github.com/alankrantas/micropython-TTP229-BSF
4x4-keypad capacitive capacitive-touch-sensor esp32 esp8266 keypad micropython micropython-esp32 micropython-esp8266 ttp229
Last synced: about 2 months ago
JSON representation
MicroPython ESP8266/ESP32 driver for TTP229-BSF 16-key capacitive keypad in serial interface mode
- Host: GitHub
- URL: https://github.com/alankrantas/micropython-TTP229-BSF
- Owner: alankrantas
- License: gpl-3.0
- Created: 2019-11-18T14:18:16.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2021-08-04T03:50:45.000Z (over 3 years ago)
- Last Synced: 2024-04-22T13:30:47.755Z (9 months ago)
- Topics: 4x4-keypad, capacitive, capacitive-touch-sensor, esp32, esp8266, keypad, micropython, micropython-esp32, micropython-esp8266, ttp229
- Language: Python
- Homepage:
- Size: 28.3 KB
- Stars: 15
- Watchers: 3
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-micropython - micropython-TTP229-BSF - MicroPython ESP8266/ESP32 driver for TTP229-BSF 16-key capacitive keypad in serial interface mode. (Libraries / Sensors)
README
# MicroPython ESP8266/ESP32 Driver for TTP229-BSF 16-key Capacitive Keypad in Serial Interface Mode
This MicroPython driver is for TTP229-BSF capacitive keypad on ESP8266/ESP32. Tested on both ESP8266 (WeMos D1 mini) and ESP32 (BPI:bit) with v1.11 firmware.
The serial interface of TTP229-BSF is not I2C but it allows you to control this keypad via only 2 wires. Not to be confused with TTP229-LSF, which is a true I2C device.
## Hardware Configuration
TTP229-BSF's serial interface supports either 8 or 16 key mode (see [datasheet](https://www.sunrom.com/get/611100)), as well as single/multiple key mode. For some of the settings hardware configuration is required:
**Connect these places with either simple wires or soldering. Do not use resistors.**
* TP2 not connected: 8 keys
* TP2 connected (pulled low): 16 keys
* TP3 and TP4 not connected: single key mode
* TP3 and TP4 both connected (pulled low): multiple key mode
Without any modification the TTP229-BSF is in 8-key/single mode. Connect the TPx pins by wires or soldering to enable these options.
## Wiring
* VCC: 3.3V
* GND: GND
* SCL: scl pin (output)
* SDO (not SDA): sdo pin (input)
## Example
```python
from machine import Pin
from TTP229_BSF import Keypad
scl_pin = Pin(5, Pin.OUT)
sdo_pin = Pin(4, Pin.IN)
keypad = Keypad(scl=scl_pin, sdo=sdo_pin, inputs=16, multi=False)
while True:
print(keypad.read())
# return a index number like 15 in single mode
# return a list like (0, 2, 11, 15) in multiple mode
```
## Parameter
You can set the following initializing parameter:
* **input=8** (default): 8 key mode
* **input=16**: 16 key mode
multi parameter:
* **multi=False** (default): single mode
* **multi=True**: multiple mode
In single mode ```keypad.read()``` will return the index of the pressed key (0~15). Return -1 when no key is pressed.
In multiple mode ```keypad.read()``` will return a list containing all the indexes of pressed keys. Return an empty list when no key is pressed.
If the TTP229-BSF is configured to multiple mode, read it in single mode will return the lowest index of all pressed keys. Read in multiple mode for a keypad configured in single mode, you'll get a list containing only one key index if any key is pressed.
There's also a raw parameter, default ```False```. When set as ```True```, ```keypad.read()``` will return the raw 8 or 16 key list indicating all keys' status (from key 0 to 15; value 1 = not pressed, 0 = pressed).
```python
keypad = Keypad(scl=scl_pin, sdo=sdo_pin, inputs=16, multi=False, raw=True)
# return a list like (0, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 1, 1, 0)
while True:
print(keypad.read())
```
If the keypad is configured to multiple mode and you read it in single/raw mode, you'll still get a list which contains multiple key pressing results.