1.. _buydisplay_2_8_tft_touch_arduino:
2
3Buydisplay 2.8" TFT Touch Shield with Arduino adapter
4#####################################################
5
6Overview
7********
8
9The Buydisplay 2.8" TFT Touch Shield has a resolution of 320x240
10pixels and is based on the ILI9341 controller. This shield comes with
11a capacitive FT6206 controller touchscreen. The Arduino adapter is
12required to use this shield.
13
14More information about the shield and Arduino adapter can be found at
15the `Buydisplay 2.8" TFT Touch Shield website`_ and
16`Arduino adapter website`_.
17
18Pin Assignments
19===============
20
21+-----------------------+---------------------------------------------+
22| Shield Connector Pin  | Function                                    |
23+=======================+=============================================+
24| D5                    | Touch Controller IRQ (see note below)       |
25+-----------------------+---------------------------------------------+
26| D7                    | ILI9341 DC       (Data/Command)             |
27+-----------------------+---------------------------------------------+
28| D10                   | ILI9341 Reset                               |
29+-----------------------+---------------------------------------------+
30| D9                    | ILI9341 SPI CSn                             |
31+-----------------------+---------------------------------------------+
32| D11                   | SPI MOSI         (Serial Data Input)        |
33+-----------------------+---------------------------------------------+
34| D12                   | SPI MISO         (Serial Data Out)          |
35+-----------------------+---------------------------------------------+
36| D13                   | SPI SCK          (Serial Clock Input)       |
37+-----------------------+---------------------------------------------+
38| SDA                   | FT6206 SDA                                  |
39+-----------------------+---------------------------------------------+
40| SCL                   | FT6206 SCL                                  |
41+-----------------------+---------------------------------------------+
42
43.. note::
44   Touch controller IRQ line is not connected by default. You will need
45   to solder the ``5 INT`` jumper to use it. You will also need to
46   adjust driver configuration and its Device Tree entry to make use of
47   it.
48
49Requirements
50************
51
52This shield can only be used with a board which provides a configuration
53for Arduino connectors and defines node aliases for SPI and GPIO interfaces
54(see :ref:`shields` for more details).
55
56Programming
57***********
58
59Set ``--shield buydisplay_2_8_tft_touch_arduino`` when you invoke
60``west build``. For example:
61
62.. zephyr-app-commands::
63   :zephyr-app: samples/subsys/display/lvgl
64   :board: nrf52840dk/nrf52840
65   :shield: buydisplay_2_8_tft_touch_arduino
66   :goals: build
67
68References
69**********
70
71.. target-notes::
72
73.. _Buydisplay 2.8" TFT Touch Shield website:
74   https://www.buydisplay.com/2-8-inch-tft-touch-shield-for-arduino-w-capacitive-touch-screen-module
75
76.. _Arduino adapter website:
77   https://www.buydisplay.com/arduino-shield-for-tft-lcd-with-ili9341-controller-and-arduino-due-mega-uno
78