ft5336

Crates.ioft5336
lib.rsft5336
version0.2.0
sourcesrc
created_at2022-01-06 15:46:22.946058
updated_at2023-05-16 13:16:57.835224
descriptionA platform agnostic driver for the FT5336 touch screen driver used on the STM32F746 Discovery board, built using the embedded-hal
homepage
repositoryhttps://github.com/bobgates/ft5336
max_upload_size
id509021
size64,835
bobgates (bobgates)

documentation

README

ft5336 Touchscreen controller

Platform agnostic driver for an FT5336 touch screen controller built using the embedded-hal.

The code is [no_main] and [no_std] compliant. The FT5336 is an I2C driven touch controller used in the STM32F746 DISCOVERY board. I cannot find a datasheet for it, so much of this comes from the STMicroelectronics Github pages: https://github.com/STMicroelectronics/stm32-ft5336 generated by the STM32Cube.

The FT5336 is a member of a family, but this code has only been tested on the single device, and only in a limited manner.

This device driver is based on the interface of the tsl256x device driver by Josh McGuigan (https://github.com/JoshMcguigan/tsl256x) and is largely in line with the thoughts expressed on his blog: https://www.joshmcguigan.com/blog/tsl256x-light-intensity-sensor-driver/ . It does not consume the I2C device, allowing for other devices to be on the same bus. That's not important on the STM32F7 Disco, but might be useful in other applications.

What works

Getting a basic x,y and touch value with weight works. The screen can detect multitouch. Getting postions for the other touches has not been tested.

TODO

Gestures etc

This turns out to be a hard problem. There is no good single source of documentation for this touchscreen driver. The FT5336 is apparently being deprecated by the manufacturers, and newer ST boards use a different touch controller. So I'm not going to go further than what is here. I fancied some gestures, but can live without them, or write my own implementations.

Example

The following example should work if you're

  • connected to an STM32F746 Discovery board, via the ST_Link port (the USB- mini type B port)
  • have embedded Rust dev tools installed, and
  • run the command: cargo embed example=touch --features=stm32f746

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Commit count: 7

cargo fmt