shields: adafruit_2_8_tft_touch_v2: add note about touch IRQ

Add note about the availability of touch panel IRQ linei when a jumper in the board is soldered. A Device Tree commented entry has also been added to ease testing it. Signed-off-by: Gerard Marull-Paretas <[email protected]>
k0d · Aug 12, 2020 · a07d66a · a07d66a
1 parent eacffdb
commit a07d66a
Show file tree

Hide file tree

Showing 3 changed files with 10 additions and 0 deletions.
diff --git a/boards/shields/adafruit_2_8_tft_touch_v2/Kconfig.defconfig b/boards/shields/adafruit_2_8_tft_touch_v2/Kconfig.defconfig
@@ -19,6 +19,7 @@ config I2C
 config KSCAN_FT5336
 	default y
 
+# NOTE: Enable if IRQ line is available (requires to solder jumper)
 config KSCAN_FT5336_INTERRUPT
 	default n
 

diff --git a/boards/shields/adafruit_2_8_tft_touch_v2/adafruit_2_8_tft_touch_v2.overlay b/boards/shields/adafruit_2_8_tft_touch_v2/adafruit_2_8_tft_touch_v2.overlay
@@ -23,5 +23,7 @@
 		compatible = "focaltech,ft5336";
 		reg = <0x38>;
 		label = "FT5336";
+		/* Uncomment if IRQ line is available (requires to solder jumper) */
+		/* int-gpios = <&arduino_header 13 GPIO_ACTIVE_LOW>; */ /* D7 */
 	};
 };
diff --git a/boards/shields/adafruit_2_8_tft_touch_v2/doc/index.rst b/boards/shields/adafruit_2_8_tft_touch_v2/doc/index.rst
@@ -23,6 +23,8 @@ Pins Assignment of the Adafruit 2.8" TFT Touch Shield v2
 +=======================+=============================================+
 | D4                    | MicroSD SPI CSn                             |
 +-----------------------+---------------------------------------------+
+| D7                    | Touch Controller IRQ (see note below)       |
++-----------------------+---------------------------------------------+
 | D8                    | STMPE610 SPI CSn (Resistive Touch Version)  |
 +-----------------------+---------------------------------------------+
 | D9                    | ILI9341 DC       (Data/Command)             |
@@ -40,6 +42,11 @@ Pins Assignment of the Adafruit 2.8" TFT Touch Shield v2
 | SCL                   | FT6206 SCL       (Capacitive Touch Version) |
 +-----------------------+---------------------------------------------+
 
+.. note::
+   Touch controller IRQ line is not connected by default. You will need to
+   solder the ``ICSP_SI1`` jumper to use it. You will also need to adjust
+   driver configuration and its Device Tree entry to make use of it.
+
 Requirements
 ************