skip to docs

xpt2046-circuitpython

A CircuitPython (or Adafruit-Blinka) library which reads values from an XPT2046 chip, commonly found on cheap microcontroller TFT displays.

installation

This project is available on PyPi:

pip3 install xpt2046-circuitpython

Or, to install it manually:

git clone https://github.com/humeman/xpt2046-circuitpython
cd xpt2046-circuitpython
pip3 install .

If you're using this on regular Linux rather than CircuitPython, make sure you also install Adafruit Blinka.

usage

Be sure to enable SPI in sudo raspi-config before proceeding.

sample wiring

examples

The most basic read example is:

import xpt2046_circuitpython
import time
import busio
import digitalio
from board import SCK, MOSI, MISO, D6, D22

# Pin config
T_CS_PIN = D6
T_IRQ_PIN = D22

# Set up SPI bus using hardware SPI
spi = busio.SPI(clock=SCK, MOSI=MOSI, MISO=MISO)
# Create touch controller
touch = xpt2046.Touch(
    spi, 
    cs = digitalio.DigitalInOut(T_CS_PIN),
    interrupt = digitalio.DigitalInOut(T_IRQ_PIN)
)

# Check if we have an interrupt signal
if touch.is_pressed():
    # Get the coordinates for this touch
    print(touch.get_coordinates())

Some more examples:

• read.py: A simple program which continuously prints coordinates when the screen is pressed
• adafruit-ili.py: A simple drawing program for an ILI9341 display controlled by the Adafruit display library