TM_TOUCH

Touch library for touch screen controllers - http://stm32f4-discovery.com/2015/08/hal-library-23-touch-for-stm32fxxx/. More...

Modules
	TM_TOUCH_Macros
	Library defines.
	TM_TOUCH_Typedefs
	Library Typedefs.
	TM_TOUCH_Functions
	Library Functions.

Detailed Description

Touch library for touch screen controllers - http://stm32f4-discovery.com/2015/08/hal-library-23-touch-for-stm32fxxx/.

This library is a "high" level library for working with touch screens. It needs low level drivers (read/write functions) specially for your touch controller.

When you have your driver written, 2 functions are needed:

• Function for touch initialization
• Function for touch read coordinates

When you call TM_TOUCH_Init function, you also have to specify some parameters for low level functions.

Set built-in driver

Note

If you follow my description in TM_DISCO library on how to select your used board, then this library will automatically select your "target".

//Use touch driver on STM32F7-Discovery, FT5336 controller
#define TOUCH_USE_STM32F7_DISCOVERY
    
//Use touch driver on STM32F439-Eval board, TS3510 controller
#define TOUCH_USE_STM32F439_EVAL

Note

When selecting "built-in" drivers, you also have to include some libs.

• TM_TOUCH_TS3510 library for STM32F439-Eval
• TM_TOUCH_FT5336 for STM32F7-Discovery

Set custom driver

Setting custom driver needs special structure where you pass pointers to your low level driver functions.

You can see example on how to do that.

//Create variable with structure
TM_TOUCH_DRIVER_t MyDriver;

//Working touch screen structure
TM_TOUCH_t TS;

//Create functions for custom TOUCH driver
//Init function
uint8_t MYDRIVER_Init(TM_TOUCH_t* TS) {
  //Initialize your custom driver here.
  
  //Set max X and Y location for touch
  TS->MaxX = MAX_X_VALUE;
  TS->MaxY = MAX_Y_VALUE;
}

//Read function
uint8_t MYDRIVER_Read(TM_TOUCH_t* TS) {
  //Read coordinates and check if pressed here
  TS->NumPresses = NumberOfFingersDetected

  //Save coordinates
  TS->X[0] = Finger1_X_Location;
  TS->Y[0] = Finger1_Y_Location;
}

//In main function for example:
int main() { 
  //Pass init and read functions
  MyDriver.Init = MYDRIVER_Init;
  MyDriver.Read = MYDRIVER_Read;

  //Init touch library
  TM_TOUCH_Init(&MyDriver, &TS);

  while (1) {
    //Read touch and process
    TM_TOUCH_Read(&TS);
    
    //Check presses
    if (TS.NumPresses > 0) {
      //At least one touch detected
    }
  }
}

Changelog

 Version 1.0
  - First release

Dependencies

 - STM32Fxxx HAL
 - defines.h
 - TM TOUCH TS3510
 - TM TOUCH FT5336
 - TM I2C
 - TM GPIO