Skip to content

Latest commit

 

History

History
48 lines (31 loc) · 1.77 KB

README.md

File metadata and controls

48 lines (31 loc) · 1.77 KB
Raw

XPT2046_Bitbang_Slim Library for Arduino

XPT2046_Bitbang_Slim is an Arduino library that provides a bit-banged SPI interface to communicate with XPT2046 touchscreen controllers. This library is ideal for users who require greater flexibility in pin choice for the MOSI, MISO, CLK, and CS lines.

This is a fork of the original XPT2046_Bitbang_Slim library, rewritten to work without SPIFFS dependency.

Really I made this for those esp32-2432S028R and esp32-2432S024R ESP32 Cheap Yellow Displays, though it should be compatible with a lot more. It's just that those boards had unusual hard-wired software SPI. image

Features

  • Manual bit-banging SPI communication
  • Calibration of the touchscreen
  • Getting touchscreen coordinates

Installation

  1. Download the repository as a zip file.
  2. In the Arduino IDE, go to Sketch -> Include Library -> Add .ZIP Library and select the downloaded zip file.
  3. The library should now be available in your Arduino IDE.

Usage

Initialization

#define MOSI_PIN 32
#define MISO_PIN 39
#define CLK_PIN  25
#define CS_PIN   33

#include <XPT2046_Bitbang.h>

XPT2046_Bitbang touchscreen(MOSI_PIN, MISO_PIN, CLK_PIN, CS_PIN);

Basic methods

  • begin(): Initializes the touchscreen.
  • setCalibration(): Set calibration values.
  • getTouch(): Gets the current touch point. Returns a TouchPoint struct with x, y, xRaw, yRaw and zRaw members.

Example

Refer to basic_touch.ino for a usage example. This example demonstrates the initialization and reading of touch points.

Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you'd like to change.