1.. _buydisplay_3_5_tft_touch_arduino:
2
3Buydisplay 3.5" TFT Touch Shield with Arduino adapter
4#####################################################
5
6Overview
7********
8
9The Buydisplay 3.5" TFT Touch Shield has a resolution of 320x480
10pixels and is based on the ILI9488 controller. On the capacitive touch
11version this shield comes with a FT6236 touch controller. The Arduino
12adapter is required to use this shield. Note that both display and
13Arduino shields are sold in multiple combinations of interfaces. The
14current Zephyr driver only supports the 4-wire SPI interface.
15
16More information about the shield and Arduino adapter can be found at
17the `Buydisplay 3.5" TFT Touch Shield website`_ and
18`Arduino adapter website`_.
19
20Pin Assignments
21===============
22
23+-----------------------+---------------------------------------------+
24| Shield Connector Pin  | Function                                    |
25+=======================+=============================================+
26| D5                    | Touch Controller IRQ (see note below)       |
27+-----------------------+---------------------------------------------+
28| D7                    | ILI9488 DC       (Data/Command)             |
29+-----------------------+---------------------------------------------+
30| D10                   | ILI9488 Reset                               |
31+-----------------------+---------------------------------------------+
32| D9                    | ILI9488 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                   | FT6236 SDA                                  |
41+-----------------------+---------------------------------------------+
42| SCL                   | FT6236 SCL                                  |
43+-----------------------+---------------------------------------------+
44
45.. note::
46   Touch controller IRQ line is not connected by default. You will need
47   to solder the ``5 INT`` jumper to use it. You will also need to
48   adjust driver configuration and its Device Tree entry to make use of
49   it.
50
51Requirements
52************
53
54This shield can only be used with a board which provides a configuration
55for Arduino connectors and defines node aliases for SPI and GPIO interfaces
56(see :ref:`shields` for more details).
57
58Programming
59***********
60
61Set ``--shield buydisplay_3_5_tft_touch_arduino`` when you invoke
62``west build``. For example:
63
64.. zephyr-app-commands::
65   :zephyr-app: samples/subsys/display/lvgl
66   :board: nrf52840dk/nrf52840
67   :shield: buydisplay_3_5_tft_touch_arduino
68   :goals: build
69
70References
71**********
72
73.. target-notes::
74
75.. _Buydisplay 3.5" TFT Touch Shield website:
76   https://www.buydisplay.com/lcd-3-5-inch-320x480-tft-display-module-optl-touch-screen-w-breakout-board
77
78.. _Arduino adapter website:
79   https://www.buydisplay.com/arduino-3-5-tft-lcd-touch-shield-serial-spi-example-for-mega-due
80