|
STM32412G-Discovery BSP User Manual
|
stm32412g_discovery_ts.c
Go to the documentation of this file.
00001 /** 00002 ****************************************************************************** 00003 * @file stm32412g_discovery_ts.c 00004 * @author MCD Application Team 00005 * @version V2.0.0 00006 * @date 27-January-2017 00007 * @brief This file provides a set of functions needed to manage the Touch 00008 * Screen on STM32412G-DISCOVERY evaluation board. 00009 ****************************************************************************** 00010 * @attention 00011 * 00012 * <h2><center>© COPYRIGHT(c) 2017 STMicroelectronics</center></h2> 00013 * 00014 * Redistribution and use in source and binary forms, with or without modification, 00015 * are permitted provided that the following conditions are met: 00016 * 1. Redistributions of source code must retain the above copyright notice, 00017 * this list of conditions and the following disclaimer. 00018 * 2. Redistributions in binary form must reproduce the above copyright notice, 00019 * this list of conditions and the following disclaimer in the documentation 00020 * and/or other materials provided with the distribution. 00021 * 3. Neither the name of STMicroelectronics nor the names of its contributors 00022 * may be used to endorse or promote products derived from this software 00023 * without specific prior written permission. 00024 * 00025 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 00026 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 00027 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 00028 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE 00029 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 00030 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 00031 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 00032 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 00033 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 00034 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 00035 * 00036 ****************************************************************************** 00037 */ 00038 00039 /* File Info : ----------------------------------------------------------------- 00040 User NOTES 00041 1. How To use this driver: 00042 -------------------------- 00043 - This driver is used to drive the touch screen module of the STM32412G-DISCOVERY 00044 evaluation board on the FRIDA LCD mounted on MB1209 daughter board. 00045 The touch screen driver IC is a FT6x36 type which share the same register naming 00046 with FT6206 type. 00047 00048 2. Driver description: 00049 --------------------- 00050 + Initialization steps: 00051 o Initialize the TS module using the BSP_TS_Init() function. This 00052 function includes the MSP layer hardware resources initialization and the 00053 communication layer configuration to start the TS use. The LCD size properties 00054 (x and y) are passed as parameters. 00055 o If TS interrupt mode is desired, you must configure the TS interrupt mode 00056 by calling the function BSP_TS_ITConfig(). The TS interrupt mode is generated 00057 as an external interrupt whenever a touch is detected. 00058 00059 + Touch screen use 00060 o The touch screen state is captured whenever the function BSP_TS_GetState() is 00061 used. This function returns information about the last LCD touch occurred 00062 in the TS_StateTypeDef structure. 00063 ------------------------------------------------------------------------------*/ 00064 00065 /* Includes ------------------------------------------------------------------*/ 00066 #include "stm32412g_discovery.h" 00067 #include "stm32412g_discovery_ts.h" 00068 00069 /** @addtogroup BSP 00070 * @{ 00071 */ 00072 00073 /** @addtogroup STM32412G_DISCOVERY 00074 * @{ 00075 */ 00076 00077 /** @defgroup STM32412G_DISCOVERY_TS STM32412G-DISCOVERY TS 00078 * @{ 00079 */ 00080 00081 /** @defgroup STM32412G_DISCOVERY_TS_Private_Variables STM32412G Discovery TS Private Variables 00082 * @{ 00083 */ 00084 static TS_DrvTypeDef *tsDriver; 00085 static uint8_t I2C_Address = 0; 00086 static uint8_t tsOrientation = TS_SWAP_NONE; 00087 00088 /* Table for touchscreen event information display on LCD : table indexed on enum @ref TS_TouchEventTypeDef information */ 00089 char * ts_event_string_tab[TOUCH_EVENT_NB_MAX] = { "None", 00090 "Press down", 00091 "Lift up", 00092 "Contact" 00093 }; 00094 00095 /* Table for touchscreen gesture Id information display on LCD : table indexed on enum @ref TS_GestureIdTypeDef information */ 00096 char * ts_gesture_id_string_tab[GEST_ID_NB_MAX] = { "None", 00097 "Move Up", 00098 "Move Right", 00099 "Move Down", 00100 "Move Left", 00101 "Zoom In", 00102 "Zoom Out" 00103 }; 00104 /** 00105 * @} 00106 */ 00107 00108 /** @defgroup STM32412G_DISCOVERY_TS_Private_Functions STM32412G Discovery TS Private Functions 00109 * @{ 00110 */ 00111 /** 00112 * @brief Initializes and configures the touch screen functionalities and 00113 * configures all necessary hardware resources (GPIOs, I2C, clocks..). 00114 * @param ts_SizeX : Maximum X size of the TS area on LCD 00115 * @param ts_SizeY : Maximum Y size of the TS area on LCD 00116 * @retval TS_OK if all initializations are OK. Other value if error. 00117 */ 00118 uint8_t BSP_TS_Init(uint16_t ts_SizeX, uint16_t ts_SizeY) 00119 { 00120 return (BSP_TS_InitEx(ts_SizeX, ts_SizeY, TS_ORIENTATION_LANDSCAPE)); 00121 } 00122 00123 /** 00124 * @brief Initializes and configures the touch screen functionalities and 00125 * configures all necessary hardware resources (GPIOs, I2C, clocks..) 00126 * with a given orientation 00127 * @param ts_SizeX : Maximum X size of the TS area on LCD 00128 * @param ts_SizeY : Maximum Y size of the TS area on LCD 00129 * @param orientation : TS_ORIENTATION_LANDSCAPE or TS_ORIENTATION_PORTRAIT 00130 * @retval TS_OK if all initializations are OK. Other value if error. 00131 */ 00132 uint8_t BSP_TS_InitEx(uint16_t ts_SizeX, uint16_t ts_SizeY, uint8_t orientation) 00133 { 00134 uint8_t ts_status = TS_OK; 00135 00136 /* Note : I2C_Address is un-initialized here, but is not used at all in init function */ 00137 /* but the prototype of Init() is like that in template and should be respected */ 00138 00139 /* Initialize the communication channel to sensor (I2C) if necessary */ 00140 /* that is initialization is done only once after a power up */ 00141 ft6x06_ts_drv.Init(I2C_Address); 00142 00143 /* Scan FT6x36 TouchScreen IC controller ID register by I2C Read */ 00144 /* Verify this is a FT6x36, otherwise this is an error case */ 00145 if(ft6x06_ts_drv.ReadID(TS_I2C_ADDRESS) == FT6x36_ID_VALUE) 00146 { 00147 /* Found FT6x36 : Initialize the TS driver structure */ 00148 tsDriver = &ft6x06_ts_drv; 00149 00150 I2C_Address = TS_I2C_ADDRESS; 00151 00152 /* Get LCD chosen orientation */ 00153 if(orientation == TS_ORIENTATION_PORTRAIT) 00154 { 00155 tsOrientation = TS_SWAP_X | TS_SWAP_Y; 00156 } 00157 else if(orientation == TS_ORIENTATION_LANDSCAPE_ROT180) 00158 { 00159 tsOrientation = TS_SWAP_XY; 00160 } 00161 else 00162 { 00163 tsOrientation = TS_SWAP_XY | TS_SWAP_Y; 00164 } 00165 00166 if(ts_status == TS_OK) 00167 { 00168 /* Software reset the TouchScreen */ 00169 tsDriver->Reset(I2C_Address); 00170 00171 /* Calibrate, Configure and Start the TouchScreen driver */ 00172 tsDriver->Start(I2C_Address); 00173 00174 } /* of if(ts_status == TS_OK) */ 00175 } 00176 else 00177 { 00178 ts_status = TS_DEVICE_NOT_FOUND; 00179 } 00180 00181 return (ts_status); 00182 } 00183 00184 /** 00185 * @brief Configures and enables the touch screen interrupts. 00186 * @retval TS_OK if all initializations are OK. Other value if error. 00187 */ 00188 uint8_t BSP_TS_ITConfig(void) 00189 { 00190 uint8_t ts_status = TS_OK; 00191 00192 /* Msp Init of GPIO used for TS_INT pin coming from TouchScreen driver IC FT6x36 */ 00193 /* When touchscreen is operated in interrupt mode */ 00194 BSP_TS_INT_MspInit(); 00195 00196 /* Enable and set the TS_INT EXTI Interrupt to an intermediate priority */ 00197 HAL_NVIC_SetPriority((IRQn_Type)(TS_INT_EXTI_IRQn), 0x0F, 0x00); 00198 HAL_NVIC_EnableIRQ((IRQn_Type)(TS_INT_EXTI_IRQn)); 00199 00200 /* Enable the TS in interrupt mode */ 00201 /* In that case the INT output of FT6206 when new touch is available */ 00202 /* is active on low level and directed on EXTI */ 00203 tsDriver->EnableIT(I2C_Address); 00204 00205 return (ts_status); 00206 } 00207 00208 /** 00209 * @brief Returns status and positions of the touch screen. 00210 * @param TS_State: Pointer to touch screen current state structure 00211 * @retval TS_OK if all initializations are OK. Other value if error. 00212 */ 00213 uint8_t BSP_TS_GetState(TS_StateTypeDef *TS_State) 00214 { 00215 static uint32_t _x[TS_MAX_NB_TOUCH] = {0, 0}; 00216 static uint32_t _y[TS_MAX_NB_TOUCH] = {0, 0}; 00217 uint8_t ts_status = TS_OK; 00218 uint16_t tmp; 00219 uint16_t Raw_x[TS_MAX_NB_TOUCH]; 00220 uint16_t Raw_y[TS_MAX_NB_TOUCH]; 00221 uint16_t xDiff; 00222 uint16_t yDiff; 00223 uint32_t index; 00224 #if (TS_MULTI_TOUCH_SUPPORTED == 1) 00225 uint32_t weight = 0; 00226 uint32_t area = 0; 00227 uint32_t event = 0; 00228 #endif /* TS_MULTI_TOUCH_SUPPORTED == 1 */ 00229 00230 /* Check and update the number of touches active detected */ 00231 TS_State->touchDetected = tsDriver->DetectTouch(I2C_Address); 00232 if(TS_State->touchDetected) 00233 { 00234 for(index=0; index < TS_State->touchDetected; index++) 00235 { 00236 /* Get each touch coordinates */ 00237 tsDriver->GetXY(I2C_Address, &(Raw_x[index]), &(Raw_y[index])); 00238 00239 if(tsOrientation & TS_SWAP_XY) 00240 { 00241 tmp = Raw_x[index]; 00242 Raw_x[index] = Raw_y[index]; 00243 Raw_y[index] = tmp; 00244 } 00245 00246 if(tsOrientation & TS_SWAP_X) 00247 { 00248 Raw_x[index] = FT_6206_MAX_WIDTH_HEIGHT - 1 - Raw_x[index]; 00249 } 00250 00251 if(tsOrientation & TS_SWAP_Y) 00252 { 00253 Raw_y[index] = FT_6206_MAX_WIDTH_HEIGHT - 1 - Raw_y[index]; 00254 } 00255 00256 xDiff = Raw_x[index] > _x[index]? (Raw_x[index] - _x[index]): (_x[index] - Raw_x[index]); 00257 yDiff = Raw_y[index] > _y[index]? (Raw_y[index] - _y[index]): (_y[index] - Raw_y[index]); 00258 00259 if ((xDiff + yDiff) > 5) 00260 { 00261 _x[index] = Raw_x[index]; 00262 _y[index] = Raw_y[index]; 00263 } 00264 00265 00266 TS_State->touchX[index] = _x[index]; 00267 TS_State->touchY[index] = _y[index]; 00268 00269 #if (TS_MULTI_TOUCH_SUPPORTED == 1) 00270 00271 /* Get touch info related to the current touch */ 00272 ft6x06_TS_GetTouchInfo(I2C_Address, index, &weight, &area, &event); 00273 00274 /* Update TS_State structure */ 00275 TS_State->touchWeight[index] = weight; 00276 TS_State->touchArea[index] = area; 00277 00278 /* Remap touch event */ 00279 switch(event) 00280 { 00281 case FT6206_TOUCH_EVT_FLAG_PRESS_DOWN : 00282 TS_State->touchEventId[index] = TOUCH_EVENT_PRESS_DOWN; 00283 break; 00284 case FT6206_TOUCH_EVT_FLAG_LIFT_UP : 00285 TS_State->touchEventId[index] = TOUCH_EVENT_LIFT_UP; 00286 break; 00287 case FT6206_TOUCH_EVT_FLAG_CONTACT : 00288 TS_State->touchEventId[index] = TOUCH_EVENT_CONTACT; 00289 break; 00290 case FT6206_TOUCH_EVT_FLAG_NO_EVENT : 00291 TS_State->touchEventId[index] = TOUCH_EVENT_NO_EVT; 00292 break; 00293 default : 00294 ts_status = TS_ERROR; 00295 break; 00296 } /* of switch(event) */ 00297 00298 #endif /* TS_MULTI_TOUCH_SUPPORTED == 1 */ 00299 00300 } /* of for(index=0; index < TS_State->touchDetected; index++) */ 00301 00302 #if (TS_MULTI_TOUCH_SUPPORTED == 1) 00303 /* Get gesture Id */ 00304 ts_status = BSP_TS_Get_GestureId(TS_State); 00305 #endif /* TS_MULTI_TOUCH_SUPPORTED == 1 */ 00306 00307 } /* end of if(TS_State->touchDetected != 0) */ 00308 00309 return (ts_status); 00310 } 00311 00312 #if (TS_MULTI_TOUCH_SUPPORTED == 1) 00313 /** 00314 * @brief Update gesture Id following a touch detected. 00315 * @param TS_State: Pointer to touch screen current state structure 00316 * @retval TS_OK if all initializations are OK. Other value if error. 00317 */ 00318 uint8_t BSP_TS_Get_GestureId(TS_StateTypeDef *TS_State) 00319 { 00320 uint32_t gestureId = 0; 00321 uint8_t ts_status = TS_OK; 00322 00323 /* Get gesture Id */ 00324 ft6x06_TS_GetGestureID(I2C_Address, &gestureId); 00325 00326 /* Remap gesture Id to a TS_GestureIdTypeDef value */ 00327 switch(gestureId) 00328 { 00329 case FT6206_GEST_ID_NO_GESTURE : 00330 TS_State->gestureId = GEST_ID_NO_GESTURE; 00331 break; 00332 case FT6206_GEST_ID_MOVE_UP : 00333 TS_State->gestureId = GEST_ID_MOVE_UP; 00334 break; 00335 case FT6206_GEST_ID_MOVE_RIGHT : 00336 TS_State->gestureId = GEST_ID_MOVE_RIGHT; 00337 break; 00338 case FT6206_GEST_ID_MOVE_DOWN : 00339 TS_State->gestureId = GEST_ID_MOVE_DOWN; 00340 break; 00341 case FT6206_GEST_ID_MOVE_LEFT : 00342 TS_State->gestureId = GEST_ID_MOVE_LEFT; 00343 break; 00344 case FT6206_GEST_ID_ZOOM_IN : 00345 TS_State->gestureId = GEST_ID_ZOOM_IN; 00346 break; 00347 case FT6206_GEST_ID_ZOOM_OUT : 00348 TS_State->gestureId = GEST_ID_ZOOM_OUT; 00349 break; 00350 default : 00351 ts_status = TS_ERROR; 00352 break; 00353 } /* of switch(gestureId) */ 00354 00355 return(ts_status); 00356 } 00357 #endif /* TS_MULTI_TOUCH_SUPPORTED == 1 */ 00358 00359 #if (TS_MULTI_TOUCH_SUPPORTED == 1) 00360 /** 00361 * @brief Function used to reset all touch data before a new acquisition 00362 * of touch information. 00363 * @param TS_State: Pointer to touch screen current state structure 00364 * @retval TS_OK if OK, TE_ERROR if problem found. 00365 */ 00366 uint8_t BSP_TS_ResetTouchData(TS_StateTypeDef *TS_State) 00367 { 00368 uint8_t ts_status = TS_ERROR; 00369 uint32_t index; 00370 00371 if (TS_State != (TS_StateTypeDef *)NULL) 00372 { 00373 TS_State->gestureId = GEST_ID_NO_GESTURE; 00374 TS_State->touchDetected = 0; 00375 00376 for(index = 0; index < TS_MAX_NB_TOUCH; index++) 00377 { 00378 TS_State->touchX[index] = 0; 00379 TS_State->touchY[index] = 0; 00380 TS_State->touchArea[index] = 0; 00381 TS_State->touchEventId[index] = TOUCH_EVENT_NO_EVT; 00382 TS_State->touchWeight[index] = 0; 00383 } 00384 00385 ts_status = TS_OK; 00386 00387 } /* of if (TS_State != (TS_StateTypeDef *)NULL) */ 00388 00389 return (ts_status); 00390 } 00391 #endif /* TS_MULTI_TOUCH_SUPPORTED == 1 */ 00392 00393 /** 00394 * @brief Initializes the TS_INT pin MSP. 00395 */ 00396 __weak void BSP_TS_INT_MspInit(void) 00397 { 00398 GPIO_InitTypeDef gpio_init_structure; 00399 00400 TS_INT_GPIO_CLK_ENABLE(); 00401 00402 /* Configure Interrupt mode for TS_INT pin falling edge : when a new touch is available */ 00403 /* TS_INT pin is active on low level on new touch available */ 00404 gpio_init_structure.Pin = TS_INT_PIN; 00405 gpio_init_structure.Pull = GPIO_PULLUP; 00406 gpio_init_structure.Speed = GPIO_SPEED_FAST; 00407 gpio_init_structure.Mode = GPIO_MODE_IT_FALLING; 00408 HAL_GPIO_Init(TS_INT_GPIO_PORT, &gpio_init_structure); 00409 } 00410 00411 /** 00412 * @} 00413 */ 00414 00415 /** 00416 * @} 00417 */ 00418 00419 /** 00420 * @} 00421 */ 00422 00423 /** 00424 * @} 00425 */ 00426 00427 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
Generated on Tue Jan 24 2017 11:28:05 for STM32412G-Discovery BSP User Manual by
1.7.6.1