Merge #527

527: Touchscreen driver r=burrbull a=Srg213

Added example to use the ft6x06 touchpanel controller. This example works on STM32F412-G and STM32F413-H discovery boards. It configures the i2c bus and uses ft6x06 crate to get touch coordinates data.

Co-authored-by: Shantanu <[email protected]>

Author: bors[bot]

CHANGELOG.md

@@ -35,6 +35,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 ### Added
 
 - Serial Tx, Rx containing pins [#514] [#515] [#540]
+- example of using ft6x06 touchscreen driver for stm32f412 and stm32f413 [#527]
+- Serial Tx, Rx containing pins [#514] [#515]
 - Implementation of From trait for Pin-to-PartiallyErasedPin [#507]
 - Implementation of From trait for Pin-to-ErasedPin [#507]
 - Implementation of From trait for PartiallyErasedPin-to-ErasedPin [#507]
@@ -61,6 +63,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 [#534]: https://github.com/stm32-rs/stm32f4xx-hal/pull/529
 [#540]: https://github.com/stm32-rs/stm32f4xx-hal/pull/540
 [#542]: https://github.com/stm32-rs/stm32f4xx-hal/pull/542
+[#527]: https://github.com/stm32-rs/stm32f4xx-hal/pull/527
 
 ## [v0.13.2] - 2022-05-16
 

Cargo.toml

@@ -82,6 +82,7 @@ smart-leds = "0.3.0"
 ws2812-spi = { version = "0.4.0", features = [] }
 hd44780-driver = "0.4.0"
 display-interface = "0.4"
+ft6x06 = "0.1.2"
 
 [dev-dependencies.time]
 version = "0.3"
@@ -368,6 +369,10 @@ debug = true
 lto = true
 opt-level = "s"
 
+[[example]]
+name= "display_touch"
+required-features = ["fsmc_lcd", "stm32f412"] #or stm32f413
+
 [[example]]
 name = "blinky-timer-irq"
 required-features = ["tim2"] # stm32f411

examples/display_touch.rs

@@ -0,0 +1,248 @@
+//!  
+//! Demonstrates use of I2C bus to configure and use FT6x06 touchscreen controller
+//!
+//! Hardware Required: STM32F412G-DISCO board or STM32F413H-DISCO board
+//!
+//! Procedure: Compile this example, load it onto the microcontroller, and run it.
+//!
+//! Example run command: `cargo run --release --features stm32f412,fsmc_lcd --example display_touch`
+//!
+//! Expected behavior: The display draws circle with its center around the touch. The co-ordinates of the touch
+//! are printed on screen.
+
+#![no_main]
+#![no_std]
+#![allow(unused_variables)]
+
+use cortex_m;
+use cortex_m_rt::entry;
+use rtt_target::{rprintln, rtt_init_print};
+#[cfg(feature = "stm32f412")]
+use stm32f4xx_hal::fsmc_lcd::ChipSelect1;
+#[cfg(feature = "stm32f413")]
+use stm32f4xx_hal::fsmc_lcd::ChipSelect3;
+use stm32f4xx_hal::{
+    fsmc_lcd::{FsmcLcd, LcdPins, Timing},
+    gpio::Speed,
+    pac,
+    prelude::*,
+    rcc::Rcc,
+};
+
+use embedded_graphics::{
+    pixelcolor::Rgb565,
+    prelude::*,
+    primitives::{Circle, PrimitiveStyle},
+};
+
+#[cfg(feature = "stm32f413")]
+use stm32f4xx_hal::fmpi2c::FMPI2c;
+#[cfg(feature = "stm32f412")]
+use stm32f4xx_hal::i2c::I2c;
+
+#[allow(unused_imports)]
+use panic_semihosting;
+
+use ft6x06::{long_hard_reset, Ft6X06};
+
+use st7789::*;
+
+/// A simple example to connect to the FT6x06 crate and get the values for
+/// x and y positions of touch.
+#[entry]
+fn main() -> ! {
+    rtt_init_print!();
+    rprintln!("Started");
+
+    let p = pac::Peripherals::take().unwrap();
+    let cp = cortex_m::Peripherals::take().unwrap();
+
+    let rcc: Rcc = p.RCC.constrain();
+
+    let clocks = rcc.cfgr.sysclk(100.MHz()).freeze();
+    let mut delay = cp.SYST.delay(&clocks);
+
+    let gpiob = p.GPIOB.split();
+    let gpioc = p.GPIOC.split();
+    let gpiod = p.GPIOD.split();
+    let gpioe = p.GPIOE.split();
+    let gpiof = p.GPIOF.split();
+    let gpiog = p.GPIOG.split();
+
+    // Pins connected to the LCD on the board
+    let lcd_pins = LcdPins {
+        data: (
+            gpiod.pd14.into_alternate(),
+            gpiod.pd15.into_alternate(),
+            gpiod.pd0.into_alternate(),
+            gpiod.pd1.into_alternate(),
+            gpioe.pe7.into_alternate(),
+            gpioe.pe8.into_alternate(),
+            gpioe.pe9.into_alternate(),
+            gpioe.pe10.into_alternate(),
+            gpioe.pe11.into_alternate(),
+            gpioe.pe12.into_alternate(),
+            gpioe.pe13.into_alternate(),
+            gpioe.pe14.into_alternate(),
+            gpioe.pe15.into_alternate(),
+            gpiod.pd8.into_alternate(),
+            gpiod.pd9.into_alternate(),
+            gpiod.pd10.into_alternate(),
+        ),
+        address: gpiof.pf0.into_alternate(),
+        read_enable: gpiod.pd4.into_alternate(),
+        write_enable: gpiod.pd5.into_alternate(),
+        #[cfg(feature = "stm32f413")]
+        chip_select: ChipSelect3(gpiog.pg10.into_alternate()),
+        #[cfg(feature = "stm32f412")]
+        chip_select: ChipSelect1(gpiod.pd7.into_alternate()),
+    };
+
+    // Enable backlight
+    #[cfg(feature = "stm32f413")]
+    let mut backlight_control = gpioe.pe5.into_push_pull_output();
+
+    #[cfg(feature = "stm32f412")]
+    let mut backlight_control = gpiof.pf5.into_push_pull_output();
+
+    backlight_control.set_high();
+
+    // Setup the RESET pin
+    #[cfg(feature = "stm32f413")]
+    let mut lcd_reset = gpiob.pb13.into_push_pull_output().speed(Speed::VeryHigh);
+
+    #[cfg(feature = "stm32f412")]
+    let lcd_reset = gpiod.pd11.into_push_pull_output().speed(Speed::VeryHigh);
+
+    #[cfg(feature = "stm32f412")]
+    let mut ts_reset = gpiof.pf12.into_push_pull_output().speed(Speed::VeryHigh);
+
+    // Workaround on STM32F413:
+    // - On the STM32F413 the touchscreen shares the reset GPIO pin w/ the LCD.
+    // - The ST7789 driver uses a fast (10uS) reset.
+    // - The touchscreen controller needs 5mS:
+    //   https://www.displayfuture.com/Display/datasheet/controller/FT6206.pdf
+    //
+    // Perform a longer reset here first.
+    //
+    #[cfg(feature = "stm32f412")]
+    long_hard_reset(&mut ts_reset, &mut delay).expect("long hard reset");
+    #[cfg(feature = "stm32f413")]
+    long_hard_reset(&mut lcd_reset, &mut delay).expect("long hard reset");
+
+    // We're not using the "tearing" signal from the display
+    let mut _te = gpiob.pb14.into_floating_input();
+
+    // Set up timing
+    let write_timing = Timing::default().data(3).address_setup(3).bus_turnaround(0);
+    let read_timing = Timing::default().data(8).address_setup(8).bus_turnaround(0);
+
+    // Initialise FSMC memory provider
+    let (_fsmc, interface) = FsmcLcd::new(p.FSMC, lcd_pins, &read_timing, &write_timing);
+
+    // Pass display-interface instance ST7789 driver to setup a new display
+    let mut disp = ST7789::new(
+        interface,
+        Some(lcd_reset),
+        Some(backlight_control),
+        240,
+        240,
+    );
+
+    // Initialise the display and clear the screen
+    disp.init(&mut delay).unwrap();
+    disp.clear(Rgb565::BLACK).unwrap();
+
+    // Orientation set is default. The touch coordinates data changes as per orientation.
+    // The touch coordinates and shapes are adjusted accordingly.
+    rprintln!("The orientation set is {}", disp.orientation() as u8);
+
+    // Intializing the i2c bus for touchscreen
+    rprintln!("Connecting to I2c");
+
+    // Declare the pins for i2c address bus on each board.
+    // STM32F412 uses I2c1 type for i2c bus.
+    // The pins are mentioned in documentation -um2135-discovery-kit-with-stm32f412zg-mcu-stmicroelectronics
+    #[cfg(feature = "stm32f412")]
+    let mut i2c = {
+        I2c::new(
+            p.I2C1,
+            (
+                gpiob.pb6.into_alternate_open_drain(), //scl pin
+                gpiob.pb7.into_alternate_open_drain(), //sda pin
+            ),
+            400.kHz(),
+            &clocks,
+        )
+    };
+
+    // STM32F413 uses FMPI2C1 type.
+    // The pins are mentioned in documentation -um2135-discovery-kit-with-stm32f413zh-mcu-stmicroelectronics
+    #[cfg(feature = "stm32f413")]
+    let mut i2c = {
+        FMPI2c::new(
+            p.FMPI2C1,
+            (
+                gpioc.pc6.into_alternate_open_drain(), // scl pin
+                gpioc.pc7.into_alternate_open_drain(), // sda pin
+            ),
+            400.kHz(),
+        )
+    };
+
+    #[cfg(feature = "stm32f412")]
+    let ts_int = gpiog.pg5.into_pull_down_input();
+    #[cfg(feature = "stm32f413")]
+    let ts_int = gpioc.pc1.into_pull_down_input();
+
+    // Create a struct of ft6x06 driver for touchscreen.
+    let mut touch = Ft6X06::new(&i2c, 0x38, ts_int).unwrap();
+
+    // Run internal calibration of touchscreen
+    let tsc = touch.ts_calibration(&mut i2c, &mut delay);
+    match tsc {
+        Err(e) => rprintln!("Error {} from ts_calibration", e),
+        Ok(u) => rprintln!("ts_calibration returned {}", u),
+    }
+    rprintln!("If nothing happens - touch the screen!");
+
+    // Loop to get the touch data
+    loop {
+        let t = touch.detect_touch(&mut i2c);
+        let mut num: u8 = 0;
+        match t {
+            Err(_e) => rprintln!("Error from fetching number of touches"),
+            Ok(n) => {
+                num = n;
+                if num != 0 {
+                    rprintln!("Number of touches: {}", num)
+                };
+            }
+        }
+
+        if num > 0 {
+            let t = touch.get_touch(&mut i2c, 1);
+
+            match t {
+                Err(_e) => rprintln!("Error fetching touch data"),
+                Ok(n) => {
+                    // Prints the touch coordinates.
+                    rprintln!(
+                        "Touch: {:>3}x{:>3} - weight: {:>3} misc: {}",
+                        n.x,
+                        n.y,
+                        n.weight,
+                        n.misc
+                    );
+
+                    // Circle with 1 pixel wide white stroke with top-left point at (10, 20) with a diameter of 3
+                    // The touchscreen coordinates are flipped and have an offset. The following conversion gives correct orientation.
+                    Circle::new(Point::new(i32::from(n.y), 240 - i32::from(n.x)), 20)
+                        .into_styled(PrimitiveStyle::with_stroke(Rgb565::RED, 1))
+                        .draw(&mut disp)
+                        .unwrap();
+                }
+            }
+        }
+    }
+}