Using the 3.5" TFT FeatherWing V2 with Arduino involves plugging a Feather board into the FeatherWing. Then, you'll install the necessary libraries and upload the example code to the Feather board.
This page uses the Feather RP2040 for demonstrating Arduino usage. You can use the same concepts to get going with any Feather board.
Plug your Feather into the FeatherWing. The USB port on the Feather will be pointing away from the microSD card slot.
Library Installation
You can install the Adafruit HX8357 library for Arduino using the Library Manager in the Arduino IDE.
Click the Manage Libraries... menu item, search for Adafruit HX8357, and select the Adafruit_HX8357_Library library:
If asked about dependencies, click "Install all".
/*************************************************** This is our library for the Adafruit HX8357D Featherwing ----> http://www.adafruit.com/products/2050 Check out the links above for our tutorials and wiring diagrams These displays use SPI to communicate, 4 or 5 pins are required to interface (RST is optional) Adafruit invests time and resources providing this open source code, please support Adafruit and open-source hardware by purchasing products from Adafruit! Written by Limor Fried/Ladyada for Adafruit Industries. MIT license, all text above must be included in any redistribution ****************************************************/ #include <Adafruit_GFX.h> // Core graphics library #include <Adafruit_HX8357.h> // If using the rev 1 with STMPE resistive touch screen controller uncomment this line: //#include <Adafruit_STMPE610.h> // If using the rev 2 with TSC2007, uncomment this line: #include <Adafruit_TSC2007.h> #ifdef ESP8266 #define STMPE_CS 16 #define TFT_CS 0 #define TFT_DC 15 #define SD_CS 2 #elif defined(ARDUINO_ADAFRUIT_FEATHER_ESP32C6) #define STMPE_CS 6 #define TFT_CS 7 #define TFT_DC 8 #define SD_CS 5 #elif defined(ESP32) && !defined(ARDUINO_ADAFRUIT_FEATHER_ESP32S2) && !defined(ARDUINO_ADAFRUIT_FEATHER_ESP32S3) #define STMPE_CS 32 #define TFT_CS 15 #define TFT_DC 33 #define SD_CS 14 #elif defined(TEENSYDUINO) #define TFT_DC 10 #define TFT_CS 4 #define STMPE_CS 3 #define SD_CS 8 #elif defined(ARDUINO_STM32_FEATHER) #define TFT_DC PB4 #define TFT_CS PA15 #define STMPE_CS PC7 #define SD_CS PC5 #elif defined(ARDUINO_NRF52832_FEATHER) /* BSP 0.6.5 and higher! */ #define TFT_DC 11 #define TFT_CS 31 #define STMPE_CS 30 #define SD_CS 27 #elif defined(ARDUINO_MAX32620FTHR) || defined(ARDUINO_MAX32630FTHR) #define TFT_DC P5_4 #define TFT_CS P5_3 #define STMPE_CS P3_3 #define SD_CS P3_2 #else // Anything else, defaults! #define STMPE_CS 6 #define TFT_CS 9 #define TFT_DC 10 #define SD_CS 5 #endif #define TFT_RST -1 // Init screen on hardware SPI, HX8357D type: Adafruit_HX8357 tft = Adafruit_HX8357(TFT_CS, TFT_DC, TFT_RST); #if defined(_ADAFRUIT_STMPE610H_) Adafruit_STMPE610 ts = Adafruit_STMPE610(STMPE_CS); #elif defined(_ADAFRUIT_TSC2007_H) // If you're using the TSC2007 there is no CS pin needed, so instead its an IRQ! #define TSC_IRQ STMPE_CS Adafruit_TSC2007 ts = Adafruit_TSC2007(); // newer rev 2 touch contoller #else #error("You must have either STMPE or TSC2007 headers included!") #endif // This is calibration data for the raw touch data to the screen coordinates // For STMPE811/STMPE610 #define STMPE_TS_MINX 3800 #define STMPE_TS_MAXX 100 #define STMPE_TS_MINY 100 #define STMPE_TS_MAXY 3750 // For TSC2007 #define TSC_TS_MINX 300 #define TSC_TS_MAXX 3800 #define TSC_TS_MINY 185 #define TSC_TS_MAXY 3700 // we will assign the calibration values on init int16_t min_x, max_x, min_y, max_y; // Size of the color selection boxes and the paintbrush size #define BOXSIZE 40 #define PENRADIUS 3 uint16_t oldcolor, currentcolor; void setup() { Serial.begin(115200); //while (!Serial) delay(10); Serial.println("HX8357D Featherwing touch test!"); #if defined(_ADAFRUIT_STMPE610H_) if (!ts.begin()) { Serial.println("Couldn't start STMPE touchscreen controller"); while (1) delay(100); } min_x = STMPE_TS_MINX; max_x = STMPE_TS_MAXX; min_y = STMPE_TS_MINY; max_y = STMPE_TS_MAXY; #else if (! ts.begin(0x48, &Wire)) { Serial.println("Couldn't start TSC2007 touchscreen controller"); while (1) delay(100); } min_x = TSC_TS_MINX; max_x = TSC_TS_MAXX; min_y = TSC_TS_MINY; max_y = TSC_TS_MAXY; pinMode(TSC_IRQ, INPUT); #endif Serial.println("Touchscreen started"); tft.begin(); tft.fillScreen(HX8357_BLACK); // make the color selection boxes tft.fillRect(0, 0, BOXSIZE, BOXSIZE, HX8357_RED); tft.fillRect(BOXSIZE, 0, BOXSIZE, BOXSIZE, HX8357_YELLOW); tft.fillRect(BOXSIZE*2, 0, BOXSIZE, BOXSIZE, HX8357_GREEN); tft.fillRect(BOXSIZE*3, 0, BOXSIZE, BOXSIZE, HX8357_CYAN); tft.fillRect(BOXSIZE*4, 0, BOXSIZE, BOXSIZE, HX8357_BLUE); tft.fillRect(BOXSIZE*5, 0, BOXSIZE, BOXSIZE, HX8357_MAGENTA); tft.fillRect(BOXSIZE*6, 0, BOXSIZE, BOXSIZE, HX8357_BLACK); tft.fillRect(BOXSIZE*6, 0, BOXSIZE, BOXSIZE, HX8357_WHITE); // select the current color 'red' tft.drawRect(0, 0, BOXSIZE, BOXSIZE, HX8357_WHITE); currentcolor = HX8357_RED; } void loop(void) { #if defined(TSC_IRQ) if (digitalRead(TSC_IRQ)) { // IRQ pin is high, nothing to read! return; } #endif TS_Point p = ts.getPoint(); Serial.print("X = "); Serial.print(p.x); Serial.print("\tY = "); Serial.print(p.y); Serial.print("\tPressure = "); Serial.print(p.z); if (((p.x == 0) && (p.y == 0)) || (p.z < 10)) return; // no pressure, no touch // Scale from ~0->4000 to tft.width using the calibration #'s p.x = map(p.x, min_x, max_x, 0, tft.width()); p.y = map(p.y, min_y, max_y, 0, tft.height()); Serial.print(" -> "); Serial.print(p.x); Serial.print(", "); Serial.println(p.y); if (p.y < BOXSIZE) { oldcolor = currentcolor; if (p.x < BOXSIZE) { currentcolor = HX8357_RED; tft.drawRect(0, 0, BOXSIZE, BOXSIZE, HX8357_WHITE); } else if (p.x < BOXSIZE*2) { currentcolor = HX8357_YELLOW; tft.drawRect(BOXSIZE, 0, BOXSIZE, BOXSIZE, HX8357_WHITE); } else if (p.x < BOXSIZE*3) { currentcolor = HX8357_GREEN; tft.drawRect(BOXSIZE*2, 0, BOXSIZE, BOXSIZE, HX8357_WHITE); } else if (p.x < BOXSIZE*4) { currentcolor = HX8357_CYAN; tft.drawRect(BOXSIZE*3, 0, BOXSIZE, BOXSIZE, HX8357_WHITE); } else if (p.x < BOXSIZE*5) { currentcolor = HX8357_BLUE; tft.drawRect(BOXSIZE*4, 0, BOXSIZE, BOXSIZE, HX8357_WHITE); } else if (p.x < BOXSIZE*6) { currentcolor = HX8357_MAGENTA; tft.drawRect(BOXSIZE*5, 0, BOXSIZE, BOXSIZE, HX8357_WHITE); } else if (p.x < BOXSIZE*7) { currentcolor = HX8357_WHITE; tft.drawRect(BOXSIZE*6, 0, BOXSIZE, BOXSIZE, HX8357_RED); } else if (p.x < BOXSIZE*8) { currentcolor = HX8357_BLACK; tft.drawRect(BOXSIZE*7, 0, BOXSIZE, BOXSIZE, HX8357_WHITE); } if (oldcolor != currentcolor) { if (oldcolor == HX8357_RED) tft.fillRect(0, 0, BOXSIZE, BOXSIZE, HX8357_RED); if (oldcolor == HX8357_YELLOW) tft.fillRect(BOXSIZE, 0, BOXSIZE, BOXSIZE, HX8357_YELLOW); if (oldcolor == HX8357_GREEN) tft.fillRect(BOXSIZE*2, 0, BOXSIZE, BOXSIZE, HX8357_GREEN); if (oldcolor == HX8357_CYAN) tft.fillRect(BOXSIZE*3, 0, BOXSIZE, BOXSIZE, HX8357_CYAN); if (oldcolor == HX8357_BLUE) tft.fillRect(BOXSIZE*4, 0, BOXSIZE, BOXSIZE, HX8357_BLUE); if (oldcolor == HX8357_MAGENTA) tft.fillRect(BOXSIZE*5, 0, BOXSIZE, BOXSIZE, HX8357_MAGENTA); if (oldcolor == HX8357_WHITE) tft.fillRect(BOXSIZE*6, 0, BOXSIZE, BOXSIZE, HX8357_WHITE); if (oldcolor == HX8357_BLACK) tft.fillRect(BOXSIZE*7, 0, BOXSIZE, BOXSIZE, HX8357_BLACK); } } if (((p.y-PENRADIUS) > 0) && ((p.y+PENRADIUS) < tft.height())) { tft.fillCircle(p.x, p.y, PENRADIUS, currentcolor); } }
Upload the sketch to your board and open up the Serial Monitor (Tools -> Serial Monitor) at 115200 baud. In the Serial Monitor, you should see the values from the touch screen being printed out.
The first number is the X coordinate, the second number is the Y coordinate and the last two numbers are Z "pressure" coordinates that can tell you how hard the touch pad is being pressed.
On the TFT, you'll be able to doodle with the different colors on the left side of the screen.
Text editor powered by tinymce.