# Adafruit 2.4" TFT FeatherWing ## Overview ![](https://cdn-learn.adafruit.com/assets/assets/000/125/506/medium800thumb/featherwings_3315-09.jpg?1697817634) A Feather board without ambition is a Feather board without FeatherWings! Spice up your Feather project with a beautiful 2.4" touchscreen display shield with built in microSD card socket. This TFT display is 2.4" diagonal with a bright 4 white-LED backlight. You get  240x320 pixels with individual 16-bit color pixel control. It has way more resolution than a black and white 128x64 display. As a bonus, this display comes with a resistive touchscreen attached to it already, so you can detect finger presses anywhere on the screen. ![](https://cdn-learn.adafruit.com/assets/assets/000/037/215/medium800/feather_3315_iso_ORIG.jpg?1478727101) This FeatherWing uses a SPI display, touchscreen and SD card socket so it works nice and fast on all our Feathers (including  **nRF52,** **ESP8266, 32u4, 328p, M0, M4, WICED ** _and_  **Teensy 3.x** ) We also include an SPI resistive touchscreen controller so you only need one additional pin to add a high quality touchscreen controller. One more pin is used for an optional SD card that can be used for storing images for display. ![](https://cdn-learn.adafruit.com/assets/assets/000/037/214/medium800/feather_3315_top_ORIG.jpg?1478727088) This Wing comes fully assembled with dual sockets for your Feather to plug into. You get two sockets per pin so you can plug in wires if you want to connect to Feather pins. Alternatively, each pin has a large square pad on the PCB for direct soldering. Four mounting holes make it easy to attach this Wing anywhere. We also include a big reset button and an on/off switch connected to the Feather Enable pin (note that the Teensy 3.x Feather does not use the Enable pin so the switch will not do anything with that type). ![](https://cdn-learn.adafruit.com/assets/assets/000/125/507/medium800/featherwings_3315-10.jpg?1697817722) **New! As of Oct 11, 2023 we've made a big redesign to this product:** We now use the TSC2007 instead of the discontinued STMPE811 touchscreen controller. The screen and micro SD card are the same but any touchscreen code will need to be updated to use our Arduino or CircuitPython library. We've also updated the reset button to be right-angle and added a STEMMA QT port. # Adafruit 2.4" TFT FeatherWing ## Pinouts - V1 Unlike most FeatherWings, the TFT FeatherWing is fully assembled and has a dual socket set for your Feather to plug into. This makes it really easy to use, but a little different to change if you don't want the default setup ## Power Pins ![](https://cdn-learn.adafruit.com/assets/assets/000/037/206/medium800/feather_power.jpg?1478726024) All power for the FeatherWing comes from the **3.3V** and **GND** pins. That includes the backlight (which can draw up to 100mA)! ![](https://cdn-learn.adafruit.com/assets/assets/000/037/207/medium800/feather_en.jpg?1478726057) You can turn off the 3.3V power supply with the **EN** pin or the switch attached to that pin. Note that on the Teensy 3x Feather Adapter, this pin doesn't do anything and on the FONA feather, this will not disable the VBAT power supply which is used to power the cellular module ## SPI Pins ![](https://cdn-learn.adafruit.com/assets/assets/000/037/208/medium800/feather_spi.jpg?1478726102) The TFT display, SD card and touch screen use the SPI interface to communicate. That means **MISO** , **MOSI** and **SCK** are used whenever either are accessed. ## TFT Control Pins ![](https://cdn-learn.adafruit.com/assets/assets/000/037/209/medium800/feather_tftctrl.jpg?1478726129) In addition, for the TFT display there is are **D/C** (Data/Command) and **CS** (Chip Select) pins. These are used to select the display and tell it what kind of data is being sent. These pins can theoretically be changed by cutting the jumper trace and soldering a small wire from the right-hand pad to the pin you'd like to use. On the **ESP8266** , TFT\_CS is pin #0, TFT\_DC is pin #15 On the **ESP32** , TFT\_CS is pin #15, TFT\_DC is pin #33 On the **Atmega32u4, ATmega328P, SAMD21 M0, nRF52840 or SAMD51 M4**  Feather, TFT\_CS is pin #9, TFT\_DC is pin #10 On the **Teensy Feather** , TFT\_CS is pin #4, TFT\_DC is pin #10 On the **WICED Feather** , TFT\_CS is PA15 and TFT\_DC is PB4 On the **nRF52832 Feather** , TFT\_CS is #31 and TFT\_DC is #11 There is also **LITE** pin which is not connected to any pads but you can use to control the backlight. Pull low to turn off the backlight. You can connect it to a PWM output pin. Warning: ## Touch Screen control pins ![](https://cdn-learn.adafruit.com/assets/assets/000/037/210/medium800/feather_touch.jpg?1478726152) The touch screen also has a Chip Select line, labeled **RT**. This pin can theoretically be changed by cutting the jumper trace and soldering a small wire from the right-hand pad to the pin you'd like to use. On the **ESP8266** , RT is pin #16 On the **ESP32** , RT is pin #32 On the **Atmega32u4, ATmega328P, nRF52840 SAMD21 M0 or SAMD51 M4**  Feather, RT is pin #6 On the **Teensy Feather** , RT is pin #3 On the **WICED Feather** , RT is PC7 On the **nRF52832 Feather** , RT is #30 There is also an **IRQ** pin which is not connected to any pads but you can use to detect when touch events have occured. ## SD Card control pins ![](https://cdn-learn.adafruit.com/assets/assets/000/037/211/medium800/feather_sd.jpg?1478726181) The SD Card also has a Chip Select line, labeled **SD**. This pin can theoretically be changed by cutting the jumper trace and soldering a small wire from the right-hand pad to the pin you'd like to use. On the **ESP8266** , SD is pin #2 On the **ESP32** SD is pin #14 On the **Atmega32u4, ATmega328P, nRF52840, SAMD21 M0 or SAMD51 M4** Feather, SD is pin #5 On the **Teensy Feather** , SD is pin #8 On the **WICED Feather** , SD is PC5 On the **nRF52 Feather** , SD is pin #27 There is also an **Card Detect (CD)** pin which is not connected to any pads but you can use to detect when a microSD card has been inserted have occured. It will be shorted to ground when a card is _not_ inserted. # Adafruit 2.4" TFT FeatherWing ## Pinouts - V2 ![](https://cdn-learn.adafruit.com/assets/assets/000/125/508/medium800/featherwings_3315-10.jpg?1697817976) The default I2C address for the TSC2007 touchscreen controller is **0x48**. ## STEMMA QT Connector - **[STEMMA QT](https://learn.adafruit.com/introducing-adafruit-stemma-qt) -** This connector, on the bottom of the FeatherWing, allows you to connect to sensors and breakout boards with STEMMA QT / Qwiic connectors or to other things with **[various associated accessories](https://www.adafruit.com/category/619).** - **SDA/SCL** - The I2C pins for the STEMMA QT connector are connected to the default I2C GPIO pins directly next to pin 5. - **3.3V/GND** - The power for the STEMMA QT connector is 3.3V. Ground is the common ground for power and logic. ## Default SPI Pins The TFT (connected to an  **ILI9341**  chipset) and microSD card on the FeatherWing are controlled via SPI.  - **MOSI**  - This is the SPI MOSI ( **M** icrocontroller  **O** ut /  **S** erial  **I** n) pin. - **MISO**  - This is the SPI MISO ( **M** icrocontroller  **I** n /  **S** erial  **O** ut) pin. - **SCK**  - This is the  **S** PI clo **ck**  input pin. ## TFT Control Pins and Jumpers - **TFTDC** - This is the display SPI **d** ata/ **c** ommand selector pin. By default, it is connected to **pin 10**. To change this, cut the jumper. Then, connect the signal pad (closest to the label on the board silk) to one of the available and compatible GPIO pads. - **TFTCS** - This is the TFT SPI **c** hip **s** elect pin. By default, is connected to **pin 9**. To change this, cut the jumper. Then, connect the signal pad (closest to the label on the board silk) to one of the available and compatible GPIO pads. - **LITE** - This is the TFT backlight pad, located between the **CD** pad and the TSC2007 chip. It is not connected to any pins by default. Pull this pin low to turn off the backlight. ## microSD Card Slot - On the back of the FeatherWing, below the on/off switch, is the microSD card slot. You can use any microSD card that supports SPI mode with one CS pin. ## SD Card Pins and Jumper - **SD** - This is the SD card **c** hip **s** elect pin. By default, it is connected to **pin 5**. To change this, cut the jumper. Then, connect the signal pad (closest to the label on the board silk) to one of the available and compatible GPIO pads. - **CD** - This is the **c** ard **d** etect pad, located to the left of the **LITE** pad and above the **A0** jumper. It is not connected to any pins by default. This pin will read low when a card is _not_ inserted. ## Touch Screen Interrupt Jumper - **IRQ** - This is the touchscreen interrupt pin. By default, it is connected to **pin 6**. To change this, cut the jumper. Then, connect the signal pad (closest to the label on the board silk) to one of the available and compatible GPIO pads. Warning: Settings an alternate I2C address on the TSC2007 requires a resistor across the jumper pad. Using a Pull-Up between 2k - 10k ohms is ideal. An 0805 SMD fits well on the jumper pad. ## TSC2007 Address Jumpers On the back of the board are **two** **address jumpers** , labeled **A0** and **A1**** ,** to the right of the board name label on the silk. These jumpers allow you to change the default I2C address of the TSC2007 on the FeatherWing. To do so, you solder the jumpers "closed" by connecting the two pads. The default I2C address is **0x48**. The other address options can be calculated by “adding” the **A0/A1** to the base of **0x48**. **A0** sets the lowest bit with a value of **1** , **A1** sets the next bit with a value of **2**. The final address is **0x48 + A1 + A0** which would be **0x4B**. 
If only **A0** is soldered closed, the address is **0x48 + 1 = 0x49** 
If only **A1** is soldered closed, the address is **0x48 + 2 = 0x4A** The table below shows all possible addresses, and whether the pin(s) should be high (closed) or low (open). ![](https://cdn-learn.adafruit.com/assets/assets/000/125/511/medium800/featherwings_adafruit_products_i2cTable.png?1697819717) ## Reset Button - **Reset** - The reset button, located in the top left corner on the FeatherWing, is connected to the reset pin. It is mounted at a right angle so that it is easier to press. ## On/Off Switch - **ON/OFF** - The On/Off switch, located on the left side of the FeatherWing, is connected to the **EN pin**. You can disconnect 3.3V power by setting the switch to **OFF**. # Adafruit 2.4" TFT FeatherWing ## TFT Graphics Test The TFT FeatherWing is basically a combination of our [2.4" TFT Breakout](../../../../adafruit-2-4-color-tft-touchscreen-breakout) with the [STMPE610 resistive touch-screen breakout attached](https://www.adafruit.com/products/1571). # Install Libraries You'll need a few libraries to use this FeatherWing! ## Install Adafruit ILI9341 TFT Library We have example code ready to go for use with these TFTs. From within the Arduino IDE, open up the **Library Manager...** ![](https://cdn-learn.adafruit.com/assets/assets/000/050/043/medium800/featherwings_managelib.png?1515773868) Search for **ILI9341** and install the **Adafruit ILI9341** library that pops up! ![](https://cdn-learn.adafruit.com/assets/assets/000/050/046/medium800/featherwings_ili9341.png?1515773948) Next up, search for  **Adafruit GFX** and locate the core library. A lot of libraries may pop up because we reference it in the description so just make sure you see **Adafruit GFX Library** in bold at the top. Install it! ![](https://cdn-learn.adafruit.com/assets/assets/000/050/044/medium800/featherwings_adafruit_products_gfx.png?1515773898) If using an earlier version of the Arduino IDE (pre-1.8.10), locate and install **Adafruit\_BusIO** (newer versions handle this prerequisite automatically). Repeat the search and install steps for the **Adafruit\_ImageReader ** library. [For more details about this process, we have a tutorial introducing Arduino library concepts and installation](http://learn.adafruit.com/adafruit-all-about-arduino-libraries-install-use). # Basic Graphics Test After installing these libraries, you should see a new **example** folder called **Adafruit\_ILI9341** and inside, an example called **graphicstest\_featherwing**. ![](https://cdn-learn.adafruit.com/assets/assets/000/037/196/medium800/feather_gfxtest.png?1478724819) Upload that sketch to your Feather. You should see a collection of graphical tests draw out on the TFT. ![](https://cdn-learn.adafruit.com/assets/assets/000/037/220/medium800/feather_3315_top_screen_03_ORIG.jpg?1478731323) ![](https://cdn-learn.adafruit.com/assets/assets/000/037/221/medium800/feather_3315_top_screen_02_ORIG.jpg?1478731339) If you're having difficulties, check the serial console.The first thing the sketch does is read the driver configuration from the TFT, you should see the same numbers as below. That will help you determine if the TFT is found, if not, check your Feather soldering! ![](https://cdn-learn.adafruit.com/assets/assets/000/037/199/medium800/feather_adafruit_products_spiilitest.gif?1478725078) Once you've got the demo working, check out the detailed documentation over at [http://learn.adafruit.com/adafruit-gfx-graphics-library](http://learn.adafruit.com/adafruit-gfx-graphics-library) for more information on how to use the GFX library to draw whatever you like! # Adafruit 2.4" TFT FeatherWing ## Adafruit GFX Library ![](https://cdn-learn.adafruit.com/assets/assets/000/025/661/medium800/adafruit_products_2478_screen_05_ORIG.jpg?1432756186) The Adafruit\_GFX library for Arduino provides a common syntax and set of graphics functions for all of our TFT, LCD and OLED displays. This allows Arduino sketches to easily be adapted between display types with minimal fuss…and any new features, performance improvements and bug fixes will immediately apply across our complete offering of color displays. The GFX library is what lets you draw points, lines, rectangles, round-rects, triangles, text, etc. ![](https://cdn-learn.adafruit.com/assets/assets/000/025/662/medium800/adafruit_products_2478_screen_01_ORIG.jpg?1432756213) Check out our detailed tutorial here [http://learn.adafruit.com/adafruit-gfx-graphics-library](http://learn.adafruit.com/adafruit-gfx-graphics-library) It covers the latest and greatest of the GFX library. The GFX library is used in both 8-bit and SPI modes so the underlying commands (drawLine() for example) are identical! # Adafruit 2.4" TFT FeatherWing ## Resistive Touch Screen - V1 The LCD has a 4-wire resistive touch screen glued onto it. You can use this for detecting finger-presses, stylus', etc. Normally, you'll need 4 pins to talk to the touch panel **but** we decided to go all snazzy and put a dedicated touch screen driver onto the shield. The driver shares the SPI pins with the TFT and SD card, so only one extra pin is needed. This allows you to query the controller when you're ready to read touchscreen data, and saves 3 pins. [To control the touchscreen you'll need one more library](https://github.com/adafruit/Adafruit_STMPE610) - the STMPE610 controller library which does all the low level chatting with the STMPE610 driver chip. Use the library manager to install the **Adafruit STMPE610** library ![](https://cdn-learn.adafruit.com/assets/assets/000/050/042/medium800/featherwings_stmpe.png?1515773665) # Touchscreen Paint Demo Now that you've got the basic TFT graphics demo working, let's add in the touchscreen. Run and upload the **touchpaint\_featherwing** demo - If you have the **2.4" TFT** Featherwing, run the **Adafruit ILI9341→touchpaint\_featherwing** demo - If you have the **3.5" TFT** Featherwing, run the **Adafruit HX8357→touchpaint\_featherwing** demo ![](https://cdn-learn.adafruit.com/assets/assets/000/037/202/medium800/feather_touchpaint.png?1478725413) Upload to your Feather and have fun! ![](https://cdn-learn.adafruit.com/assets/assets/000/037/218/medium800/feather_heart.jpg?1478730535) Danger: Getting data from the touchscreen is fairly straight forward. Start by creating the touchscreen object with > **Adafruit\_STMPE610 ts = Adafruit\_STMPE610(STMPE\_CS);** We're using hardware SPI so the clock, mosi and miso pins are not defined here. Then you can start the touchscreen with > **ts.begin()** Check to make sure this returns a True value, which means the driver was found. If it wasn't, make sure you have the Feather soldered right and the correct CS pin! Now you can call > **if (! ts.bufferEmpty()**) to check if there's any data in the buffer. The touchscreen driver will store touchpoints at all times. When you're ready to get the data, just check if there's any data in the buffer. If there is, you can call > **TS\_Point p = ts.getPoint();** To get the oldest point from the buffer. TS\_Point has **.x .y** and . **z** data points. The **x** and **y** points range from 0 to 4095. The STMPE610 does not store any calibration data in it and it doesn't know about rotation. **So if you want to rotate the screen you'll need to manually rotate the x/y points!** The z point is 'pressure' and ranges from 0 to 255, we don't use it here but you can experiment with it on your own, the harder you press, the lower the number. Since data from the STMPE610 comes in 0-4095 but our screen is 320 pixels by 240 pixels, we can use **map** to convert 0-4095 to 0-320 or 0-240. Something like > **p.x = map(p.x, 0, 4095, 0, tft.width());** > **p.y = map(p.y, 0, 4095, 0, tft.height());** However, the touchscreen is a bit bigger than the screen, so we actually need to ignore presses beyond the touchscreen itself. We found that these numbers reflected the true range that overlaps the screen > **#define TS\_MINX 150** > **#define TS\_MINY 130** > **#define TS\_MAXX 3800** > **#define TS\_MAXY 4000** So we use > **p.x = map(p.x, TS\_MINX, TS\_MAXX, 0, tft.width());** > **p.y = map(p.y, TS\_MINY, TS\_MAXY, 0, tft.height());** instead. One last point (pun intended!) since the touchscreen driver stores points in a buffer, you may want to ask the driver "is the touchscreen being pressed RIGHT NOW?" You can do that with > **if (ts.touched())** # Adafruit 2.4" TFT FeatherWing ## Resistive Touch Screen - V2 Using the 2.4" 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. Featured ### Adafruit Feather RP2040 [Adafruit Feather RP2040](https://www.adafruit.com/product/4884) A new chip means a new Feather, and the Raspberry Pi RP2040 is no exception. When we saw this chip we thought "this chip is going to be awesome when we give it the Feather Treatment" and so we did! This Feather features the  **RP2040** , and all niceties you know and... In Stock [Buy Now](https://www.adafruit.com/product/4884) [Related Guides to the Product](https://learn.adafruit.com/products/4884/guides) ![Angled shot of black rectangular microcontroller "Feather RP2040"](https://cdn-shop.adafruit.com/640x480/4884-04.jpg) ## Hardware Setup Plug your Feather into the FeatherWing. The bottom of the Feather will be above the FeatherWing STEMMA QT port. ![featherwings_3315-09_plug.jpg](https://cdn-learn.adafruit.com/assets/assets/000/125/521/medium640/featherwings_3315-09_plug.jpg?1697829358) ## Library Installation You can install the **Adafruit ILI9341** library for Arduino using the Library Manager in the Arduino IDE. ![](https://cdn-learn.adafruit.com/assets/assets/000/124/343/medium800/adafruit_products_Arduino_Open_Library_Manager.png?1694533546) Click the **Manage Libraries...** menu item, search for **Adafruit ILI9341** , and select the **Adafruit\_ILI9341** library: ![](https://cdn-learn.adafruit.com/assets/assets/000/124/359/medium800/adafruit_products_arduino_lib.png?1694544456) If asked about dependencies, click "Install all". ![](https://cdn-learn.adafruit.com/assets/assets/000/124/360/medium800/adafruit_products_depends.png?1694544423) If the "Dependencies" window does not come up, then you already have the dependencies installed. Then you'll install the Adafruit TSC2007 library for the touch screen. Click the **Manage Libraries...** menu item, search for **Adafruit TSC2007** , and select the **Adafruit TSC2007** library: ![](https://cdn-learn.adafruit.com/assets/assets/000/124/358/medium800/adafruit_products_tsc_lib.png?1694544373) If asked about dependencies, click "Install all". ![](https://cdn-learn.adafruit.com/assets/assets/000/124/361/medium800/adafruit_products_tsc_depends.png?1694544420) If the "Dependencies" window does not come up, then you already have the dependencies installed. Warning: ## Example Code https://github.com/adafruit/Adafruit_Learning_System_Guides/blob/main/TFT_FeatherWing_TSC2007_Demos/Arduino_TouchPaint_TSC2007/Arduino_TouchPaint_TSC2007.ino ![](https://cdn-learn.adafruit.com/assets/assets/000/125/522/medium800/featherwings_ard_serial.png?1697829410) 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. ![](https://cdn-learn.adafruit.com/assets/assets/000/125/523/medium800/featherwings_feather_3315_top_demo_ORIG.jpg?1697829515) # Adafruit 2.4" TFT FeatherWing ## Drawing Bitmaps There is a built-in microSD card slot on the FeatherWing, and we can use that to load bitmap images! You will need a **microSD** card formatted **FAT16 or FAT32** (they almost always are by default), and an SD card reader on whatever computer you’re currently reading this with. Its really easy to draw bitmaps. Lets start by downloading this image of pretty flowers: ![](https://cdn-learn.adafruit.com/assets/assets/000/037/204/medium800/feather_purple.bmp?1478725599 photo by johngineer) Download these two smaller images as well: ![](https://cdn-learn.adafruit.com/assets/assets/000/070/041/medium800/featherwings_parrot.bmp?1548457557) ![](https://cdn-learn.adafruit.com/assets/assets/000/070/042/medium800/featherwings_wales.bmp?1548457564) The files should be renamed (if needed) to “ **purple.bmp** ”, “ **parrot.bmp** ” and “ **wales.bmp** ”, respectively, and copied to the base directory of the microSD card (_not_ inside a folder). (If it’s easier, you can also find these images in the “images” folder within the Adafruit\_ImageReader library folder.) Insert the microSD card into the socket in the shield. Now select the sketch  **file→examples→Adafruit\_ImageReader→**** FeatherWingILI9341 **and upload this example to your Feather + Wing. You will see the flowers appear! (Plus parrots…and if you’re using one of the more powerful Feather boards, a whole lot of dragons.) ![](https://cdn-learn.adafruit.com/assets/assets/000/037/219/medium800/feather_3315_top_screen_01_ORIG.jpg?1478731294) **The Adafruit\_ImageReader library, which is being used here to display .BMP images, is [fully explained in its own page of the Adafruit\_GFX guide](https://learn.adafruit.com/adafruit-gfx-graphics-library/loading-images).** # Adafruit 2.4" TFT FeatherWing ## CircuitPython Displayio Quickstart - V1 We'll start with the 2.4" TFT FeatherWing which has an ILI9341 display on it. If you would like more information on this display, be sure to check out our [Adafruit 2.4" TFT FeatherWing guide](https://learn.adafruit.com/adafruit-2-4-tft-touch-screen-featherwing). # Parts To use this display with displayio, you will only need two main parts. First, you will need the TFT FeatherWing itself. Featured ### TFT FeatherWing - 2.4" 320x240 Touchscreen For All Feathers [TFT FeatherWing - 2.4" 320x240 Touchscreen For All Feathers](https://www.adafruit.com/product/3315) A Feather board without ambition is a Feather board without FeatherWings! Spice up your Feather project with a beautiful 2.4" touchscreen display shield with built in microSD card socket. This TFT display is 2.4" diagonal with a bright 4 white-LED backlight. You get  240x320... In Stock [Buy Now](https://www.adafruit.com/product/3315) [Related Guides to the Product](https://learn.adafruit.com/products/3315/guides) ![View of a TFT FeatherWing - 2.4" 320x240 Touchscreen For All Feathers. A polished finger drawing a heart on the touch screen. ](https://cdn-shop.adafruit.com/product-videos/640x480/3315-09.jpg) And second, you will need a Feather such as the Feather M0 Express or the Feather M4 Express. We recommend the Feather M4 Express because it's much faster and works better for driving a display. Featured ### Adafruit Feather M4 Express - Featuring ATSAMD51 [Adafruit Feather M4 Express - Featuring ATSAMD51](https://www.adafruit.com/product/3857) It's what you've been waiting for, the Feather M4 Express featuring ATSAMD51. This Feather is fast like a swift, smart like an owl, strong like a ox-bird (it's half ox, half bird, OK?) This feather is powered by our new favorite chip, the **ATSAMD51J19** -  with... In Stock [Buy Now](https://www.adafruit.com/product/3857) [Related Guides to the Product](https://learn.adafruit.com/products/3857/guides) ![Angled shot of a Adafruit Feather M4 Express. ](https://cdn-shop.adafruit.com/640x480/3857-10.jpg) For this guide, we'll assume you have a Feather M4 Express. The steps should be about the same for the Feather M0 Express. To start, if you haven't already done so, follow the assembly instructions for the Feather M4 Express in our [Feather M4 Express guide](https://learn.adafruit.com/adafruit-feather-m4-express-atsamd51/assembly). We'll start by looking at the back of the 2.4" TFT FeatherWing.  ![](https://cdn-learn.adafruit.com/assets/assets/000/075/015/medium800/circuitpython_2.4-reverse.png?1556331491) After that, it's just a matter of inserting the Feather M4 Express into the back of the TFT FeatherWing. ![](https://cdn-learn.adafruit.com/assets/assets/000/075/016/medium800/circuitpython_2.4-assembled.png?1556331529) # Required CircuitPython Libraries To use this display with `displayio`, there is only one required library. [Adafruit_CircuitPython_ILI9341](https://github.com/adafruit/Adafruit_CircuitPython_ILI9341/releases) First, make sure you are running the [latest version of Adafruit CircuitPython](https://learn.adafruit.com/welcome-to-circuitpython/installing-circuitpython) for your board. Next, you'll need to install the necessary libraries to use the hardware--carefully follow the steps to find and install these libraries from [Adafruit's CircuitPython library bundle](https://github.com/adafruit/Adafruit_CircuitPython_Bundle).  Our introduction guide has [a great page on how to install the library bundle](https://learn.adafruit.com/welcome-to-circuitpython/circuitpython-libraries) for both express and non-express boards. Remember for non-express boards, you'll need to manually install the necessary libraries from the bundle: - **adafruit\_ili9341** Before continuing make sure your board's lib folder or root filesystem has the  **adafruit\_ili9341**  file copied over. ## Code Example Additional Libraries For the Code Example, you will need an additional library. We decided to make use of a library so the code didn't get overly complicated. [Adafruit_CircuitPython_Display_Text](https://github.com/adafruit/Adafruit_CircuitPython_Display_Text) Go ahead and install this in the same manner as the driver library by copying the  **adafruit\_display\_text** folder over to the **lib** folder on your CircuitPython device. # CircuitPython Code Example https://github.com/adafruit/Adafruit_CircuitPython_ILI9341/blob/main/examples/ili9341_simpletest.py ## Code Details Let's take a look at the sections of code one by one. We start by importing the board so that we can initialize `SPI`, `displayio`, `terminalio` for the font, a `label`, and the `adafruit_ili9341` driver. ```auto import board import displayio import fourwire import terminalio from adafruit_display_text import label import adafruit_ili9341 ``` Next we release any previously used displays. This is important because if the Feather is reset, the display pins are not automatically released and this makes them available for use again. ```auto displayio.release_displays() ``` Next, we set the SPI object to the board's SPI with the easy shortcut function `board.SPI()`. By using this function, it finds the SPI module and initializes using the default SPI parameters. Next we set the Chip Select and Data/Command pins that will be used. ```auto spi = board.SPI() tft_cs = board.D9 tft_dc = board.D10 ``` In the next line, we set the display bus to FourWire which makes use of the SPI bus. The reset parameter is actually not needed for the FeatherWing, but was added to make it compatible with the breakout displays. You can either leave it or remove it if you need access to an additional GPIO pin. ```auto display_bus = fourwire.FourWire(spi, command=tft_dc, chip_select=tft_cs, reset=board.D6) ``` Finally, we initialize the driver with a width of 320 and a height of 240. If we stopped at this point and ran the code, we would have a terminal that we could type at and have the screen update. ```auto display = adafruit_ili9341.ILI9341(display_bus, width=320, height=240) ``` ![](https://cdn-learn.adafruit.com/assets/assets/000/075/034/medium800/circuitpython_2.4-terminal.png?1556510158) Next we create a background splash image. We do this by creating a group that we can add elements to and adding that group to the display. The display will automatically handle updating the group. ```auto splash = displayio.Group() display.root_group = splash ``` Next we create a Bitmap which is like a canvas that we can draw on. In this case we are creating the Bitmap to be the same size as the screen, but only have one color. The Bitmaps can currently handle up to 256 different colors. We create a Palette with one color and set that color to 0x00FF00 which happens to be green. Colors are Hexadecimal values in the format of RRGGBB. Even though the Bitmaps can only handle 256 colors at a time, you get to define what those 256 different colors are. ```auto color_bitmap = displayio.Bitmap(320, 240, 1) color_palette = displayio.Palette(1) color_palette[0] = 0x00FF00 # Bright Green ``` With all those pieces in place, we create a TileGrid by passing the bitmap and palette and draw it at `(0, 0)` which represents the display's upper left. ```auto bg_sprite = displayio.TileGrid(color_bitmap, pixel_shader=color_palette, x=0, y=0) splash.append(bg_sprite) ``` This creates a solid green background which we will draw on top of. ![](https://cdn-learn.adafruit.com/assets/assets/000/078/928/medium800/circuitpython_2.4-green.png?1564765013) Next we will create a smaller purple rectangle. The easiest way to do this is the create a new bitmap that is a little smaller than the full screen with a single color and place it in a specific location. In this case we will create a bitmap that is 20 pixels smaller on each side. The screen is 320x240, so we'll want to subtract 40 from each of those numbers. We'll also want to place it at the position `(20, 20)` so that it ends up centered. ```auto inner_bitmap = displayio.Bitmap(280, 200, 1) inner_palette = displayio.Palette(1) inner_palette[0] = 0xAA0088 # Purple inner_sprite = displayio.TileGrid(inner_bitmap, pixel_shader=inner_palette, x=20, y=20) splash.append(inner_sprite) ``` Since we are adding this after the first rectangle, it's automatically drawn on top. Here's what it looks like now. ![](https://cdn-learn.adafruit.com/assets/assets/000/078/929/medium800/circuitpython_2.4-green-purple.png?1564765446) Next let's add a label that says "Hello World!" on top of that. We're going to use the built-in Terminal Font and scale it up by a factor of three. To scale the label only, we will make use of a subgroup, which we will then add to the main group. Labels are centered vertically, so we'll place it at 120 for the Y coordinate, and around 57 pixels make it appear to be centered horizontally, but if you want to change the text, change this to whatever looks good to you. Let's go with some yellow text, so we'll pass it a value of `0xFFFF00`. ```python text_group = displayio.Group(scale=3, x=57, y=120) text = "Hello World!" text_area = label.Label(terminalio.FONT, text=text, color=0xFFFF00) text_group.append(text_area) # Subgroup for text scaling splash.append(text_group) ``` Finally, we place an infinite loop at the end so that the graphics screen remains in place and isn't replaced by a terminal. ```auto while True: pass ``` ![](https://cdn-learn.adafruit.com/assets/assets/000/078/930/medium800/circuitpython_2.4-hello-world.png?1564765810) ## Using Touch We won't be covering how to use the touchscreen on the shield with CircuitPython in this guide, but the library required for enabling resistive touch is the [Adafruit\_CircuitPython\_STMPE610](https://github.com/adafruit/Adafruit_CircuitPython_STMPE610) library. # Where to go from here Be sure to check out this excellent [guide to CircuitPython Display Support Using displayio](https://learn.adafruit.com/circuitpython-display-support-using-displayio) # Adafruit 2.4" TFT FeatherWing ## CircuitPython Displayio Quickstart - V2 Using the 2.4" TFT FeatherWing V2 with CircuitPython involves plugging a Feather board into the FeatherWing. Then, you load the code and necessary libraries onto your Feather board to run the example. This page uses the Feather RP2040 for demonstrating CircuitPython usage. You can use the same concepts to get going with any classic Feather board. Featured ### Adafruit Feather RP2040 [Adafruit Feather RP2040](https://www.adafruit.com/product/4884) A new chip means a new Feather, and the Raspberry Pi RP2040 is no exception. When we saw this chip we thought "this chip is going to be awesome when we give it the Feather Treatment" and so we did! This Feather features the  **RP2040** , and all niceties you know and... In Stock [Buy Now](https://www.adafruit.com/product/4884) [Related Guides to the Product](https://learn.adafruit.com/products/4884/guides) ![Angled shot of black rectangular microcontroller "Feather RP2040"](https://cdn-shop.adafruit.com/640x480/4884-04.jpg) ## Hardware Setup Plug your Feather into the FeatherWing. The bottom of the Feather will be above the FeatherWing STEMMA QT port. ![featherwings_3315-09_plug.jpg](https://cdn-learn.adafruit.com/assets/assets/000/125/520/medium640/featherwings_3315-09_plug.jpg?1697828809) ## CircuitPython Usage To use with CircuitPython, you need to first install the necessary libraries, and their dependencies, into the **lib** folder on your **CIRCUITPY** drive. Then you need to update **code.py** with the example script. Thankfully, we can do this in one go. In the example below, click the **Download Project Bundle** button below to download the necessary libraries and the **code.py** file in a zip file. Extract the contents of the zip file. Connect the microcontroller to your computer via a known-good USB power+data cable. The board shows up as a thumb drive named **CIRCUITPY**. Copy the **entire lib folder** , the **bitmap image files** , and the **code.py** file to your **CIRCUITPY** drive. Your **CIRCUITPY/lib** folder should contain the following folder and files: - **/adafruit\_bus\_device** - **adafruit\_ili9341.mpy** - **adafruit\_tsc2007.mpy** Once you have copied over the necessary folders and files, your **CIRCUITPY** drive should resemble the following: ![CIRCUITPY](https://adafruit.github.io/Adafruit_Learning_System_Guides/TFT_Shield_TSC2007_Demos_CircuitPython.png ) ## Example Code https://github.com/adafruit/Adafruit_Learning_System_Guides/blob/main/TFT_FeatherWing_TSC2007_Demos/CircuitPython/code.py Once everything is saved to the **CIRCUITPY** drive, [connect to the serial console](https://learn.adafruit.com/welcome-to-circuitpython/kattni-connecting-to-the-serial-console) to see the data printed out! ![](https://cdn-learn.adafruit.com/assets/assets/000/124/354/medium800/adafruit_products_cpREPL.png?1694543728) The code will open all of the bitmap files that are on the **CIRCUITPY** drive and add them to the `images` array. The first image will then be displayed on the TFT. In the loop, if you touch the screen you'll see the coordinates and pressure print to the serial console. If you press on the left side of the screen, the display will show the previous bitmap in the array. If you press on the right side of the screen, the display will show the next bitmap in the array. # Adafruit 2.4" TFT FeatherWing ## Troubleshooting ### The display driver circuit needs a small amount of time to be ready after initial power. If your code tries to write to the display too soon, it may not be ready. It will work on reset since that typically does not cycle power. If you are having this issue, try adding a small amount of delay before trying to write to the display. In Arduino, use **delay()** to add a few milliseconds before calling **tft.begin()**. Adjust the amount of delay as needed to see how little you can get away with for your specific setup. # Adafruit 2.4" TFT FeatherWing ## Downloads ## Datasheets & More - [V1 Fritzing object in Adafruit Fritzing Library](https://github.com/adafruit/Fritzing-Library/blob/master/parts/Adafruit%202.4in%20TFT%20FeatherWing.fzpz) - [V2 Fritzing object in Adafruit Fritzing Library](https://github.com/adafruit/Fritzing-Library/blob/master/parts/Adafruit%202.4%20inch%20TFT%20FeatherWing%20V2.fzpz) - [STMPE610 Touch Controller Datasheet](http://www.adafruit.com/datasheets/STMPE610.pdf) - [TSC2007 Touch Controller Datasheet](https://cdn-learn.adafruit.com/assets/assets/000/110/401/original/tsc2007.pdf?1648820788) - [ILI9341 (TFT controller) Datasheet](http://www.adafruit.com/datasheets/ILI9341.pdf "Link: http://www.adafruit.com/datasheets/ILI9341.pdf") - [Datasheet for TFT module itself](https://cdn-learn.adafruit.com/assets/assets/000/046/879/original/SPEC-YX240QV29-T_Rev.A__1_.pdf) - [EagleCAD PCB files on GitHub](https://github.com/adafruit/Adafruit-2.4-TFT-FeatherWing-PCB) - [3D Models on GitHub](https://github.com/adafruit/Adafruit_CAD_Parts/tree/main/3315%202.4%20TFT%20FeatherWing) ## Schematic and Fab Print ### V2 ![](https://cdn-learn.adafruit.com/assets/assets/000/125/517/medium800/featherwings_schem.png?1697820980) ![](https://cdn-learn.adafruit.com/assets/assets/000/125/518/medium800/featherwings_fab.png?1697820989 dimensions are in inches) ### V1 ![](https://cdn-learn.adafruit.com/assets/assets/000/037/216/medium800/feather_schem.png?1478729728) ![](https://cdn-learn.adafruit.com/assets/assets/000/037/217/medium800/feather_fabprint.png?1478729747 dimensions are in inches) ## Primary Products ### TFT FeatherWing - 2.4" 320x240 Touchscreen For All Feathers [TFT FeatherWing - 2.4" 320x240 Touchscreen For All Feathers](https://www.adafruit.com/product/3315) A Feather board without ambition is a Feather board without FeatherWings! Spice up your Feather project with a beautiful 2.4" touchscreen display shield with built in microSD card socket. This TFT display is 2.4" diagonal with a bright 4 white-LED backlight. You get  240x320... In Stock [Buy Now](https://www.adafruit.com/product/3315) [Related Guides to the Product](https://learn.adafruit.com/products/3315/guides) ## Guide Products ### Adafruit Feather RP2040 [Adafruit Feather RP2040](https://www.adafruit.com/product/4884) A new chip means a new Feather, and the Raspberry Pi RP2040 is no exception. When we saw this chip we thought "this chip is going to be awesome when we give it the Feather Treatment" and so we did! This Feather features the  **RP2040** , and all niceties you know and... In Stock [Buy Now](https://www.adafruit.com/product/4884) [Related Guides to the Product](https://learn.adafruit.com/products/4884/guides) ## Related Guides - [Introducing Adafruit Feather RP2040](https://learn.adafruit.com/adafruit-feather-rp2040-pico.md) - [Motorized POV LED Display](https://learn.adafruit.com/motorized-pov-led-display.md) - [CNC Rotary Macropad](https://learn.adafruit.com/cnc-rotary-macropad.md) - [Creating Custom Symbol Fonts for Adafruit GFX Library](https://learn.adafruit.com/creating-custom-symbol-font-for-adafruit-gfx-library.md) - [NeoPixel Rotary Fidget](https://learn.adafruit.com/neopixel-rotary-fidget.md) - [Circle of Fifths Euclidean Synth with synthio and CircuitPython](https://learn.adafruit.com/circle-of-fifths-euclidean-synth-with-synthio-and-circuitpython.md) - [Deco Two-Key Feather Macro Pad](https://learn.adafruit.com/deco-two-key-keypad-macropad-circuitpython-feather.md) - [Bubble Table with LED Animations and IR Remote Control](https://learn.adafruit.com/bubble-table-with-led-animations-and-ir-remote-control.md) - [Flying Faders](https://learn.adafruit.com/flying-faders.md) - [Thermal Camera with Display](https://learn.adafruit.com/thermal-camera-with-display.md) - [Magic Band Reader](https://learn.adafruit.com/magic-band-reader.md) - [4x4 Rotary Encoder MIDI Messenger](https://learn.adafruit.com/4x4-rotary-encoder-midi-messenger.md) - [Disconnected CO2 Data Logger](https://learn.adafruit.com/disconnected-co2-data-logger.md) - [Darth Faders](https://learn.adafruit.com/darth-faders.md) - [Pip-Boy 2040 Wrist-Mounted Prop](https://learn.adafruit.com/pip-boy-2040.md) - [LED Rocket Lamp](https://learn.adafruit.com/led-rocket-lamp.md)