1.. _adafruit_2_8_tft_touch_v2:
2
3Adafruit 2.8" TFT Touch Shield v2
4#################################
5
6Overview
7********
8
9The Adafruit 2.8" TFT Touch Shield v2 with a
10resolution of 320x240 pixels, is based on the ILI9341 controller.
11This shield comes with a resistive (STMPE610 controller)
12or capacitive (FT6206 controller) touchscreen. While the
13Zephyr RTOS supports display output to these screens,
14touchscreen input is supported only on Capacitive Touch version.
15More information about the shield can be found
16at the `Adafruit 2.8" TFT Touch Shield v2 website`_.
17
18Pins Assignment of the Adafruit 2.8" TFT Touch Shield v2
19========================================================
20
21+-----------------------+---------------------------------------------+
22| Shield Connector Pin  | Function                                    |
23+=======================+=============================================+
24| D4                    | MicroSD SPI CSn                             |
25+-----------------------+---------------------------------------------+
26| D7                    | Touch Controller IRQ (see note below)       |
27+-----------------------+---------------------------------------------+
28| D8                    | STMPE610 SPI CSn (Resistive Touch Version)  |
29+-----------------------+---------------------------------------------+
30| D9                    | ILI9341 DC       (Data/Command)             |
31+-----------------------+---------------------------------------------+
32| D10                   | ILI9341 SPI CSn                             |
33+-----------------------+---------------------------------------------+
34| D11                   | SPI MOSI         (Serial Data Input)        |
35+-----------------------+---------------------------------------------+
36| D12                   | SPI MISO         (Serial Data Out)          |
37+-----------------------+---------------------------------------------+
38| D13                   | SPI SCK          (Serial Clock Input)       |
39+-----------------------+---------------------------------------------+
40| SDA                   | FT6206 SDA       (Capacitive Touch Version) |
41+-----------------------+---------------------------------------------+
42| SCL                   | FT6206 SCL       (Capacitive Touch Version) |
43+-----------------------+---------------------------------------------+
44
45.. note::
46   Touch controller IRQ line is not connected by default. You will need to
47   solder the ``ICSP_SI1`` jumper to use it. You will also need to adjust
48   driver configuration and its Device Tree entry to make use of it.
49
50Requirements
51************
52
53This shield can only be used with a board which provides a configuration
54for Arduino or Arduino Nano connectors and defines node aliases for SPI and
55GPIO interfaces (see :ref:`shields` for more details).
56
57Programming
58***********
59
60Set ``--shield adafruit_2_8_tft_touch_v2`` when you invoke ``west build``. For example:
61
62.. zephyr-app-commands::
63   :zephyr-app: samples/subsys/display/lvgl
64   :board: nrf52840dk/nrf52840
65   :shield: adafruit_2_8_tft_touch_v2
66   :goals: build
67
68If the shield is connected to a board which has Arduino Nano connector,
69set ``--shield adafruit_2_8_tft_touch_v2_nano`` when you invoke ``west build``.
70
71.. zephyr-app-commands::
72   :zephyr-app: samples/subsys/display/lvgl
73   :board: arduino_nano_33_ble
74   :shield: adafruit_2_8_tft_touch_v2_nano
75   :goals: build
76
77References
78**********
79
80.. target-notes::
81
82.. _Adafruit 2.8" TFT Touch Shield v2 website:
83   https://learn.adafruit.com/adafruit-2-8-tft-touch-shield-v2
84