|
STM32412G-Discovery BSP User Manual
|
stm32412g_discovery_ts.h
Go to the documentation of this file.
00001 /** 00002 ****************************************************************************** 00003 * @file stm32412g_discovery_ts.h 00004 * @author MCD Application Team 00005 * @version V2.0.0 00006 * @date 27-January-2017 00007 * @brief This file contains the common defines and functions prototypes for 00008 * the stm32412g_discovery_ts.c driver. 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 /* Define to prevent recursive inclusion -------------------------------------*/ 00040 #ifndef __STM32412G_DISCOVERY_TS_H 00041 #define __STM32412G_DISCOVERY_TS_H 00042 00043 #ifdef __cplusplus 00044 extern "C" { 00045 #endif 00046 00047 /* Includes ------------------------------------------------------------------*/ 00048 #include "stm32412g_discovery.h" 00049 #include "stm32412g_discovery_lcd.h" 00050 00051 /* Include TouchScreen component driver */ 00052 #include "../Components/ft6x06/ft6x06.h" 00053 00054 /** @addtogroup BSP 00055 * @{ 00056 */ 00057 00058 /** @addtogroup STM32412G_DISCOVERY 00059 * @{ 00060 */ 00061 00062 /** @addtogroup STM32412G_DISCOVERY_TS 00063 * @{ 00064 */ 00065 00066 /** @defgroup STM32412G_DISCOVERY_TS_Exported_Constants STM32412G Discovery TS Exported Constants 00067 * @{ 00068 */ 00069 /** @brief With FT6206 : maximum 2 touches detected simultaneously 00070 */ 00071 #define TS_MAX_NB_TOUCH ((uint32_t) FT6206_MAX_DETECTABLE_TOUCH) 00072 00073 #define TS_NO_IRQ_PENDING ((uint8_t) 0) 00074 #define TS_IRQ_PENDING ((uint8_t) 1) 00075 00076 #define TS_SWAP_NONE ((uint8_t) 0x01) 00077 #define TS_SWAP_X ((uint8_t) 0x02) 00078 #define TS_SWAP_Y ((uint8_t) 0x04) 00079 #define TS_SWAP_XY ((uint8_t) 0x08) 00080 00081 #define TS_ORIENTATION_PORTRAIT ((uint8_t) 0) 00082 #define TS_ORIENTATION_LANDSCAPE ((uint8_t) 1) 00083 #define TS_ORIENTATION_LANDSCAPE_ROT180 ((uint8_t) 2) 00084 00085 /** 00086 * @} 00087 */ 00088 00089 /** @defgroup STM32412G_DISCOVERY_TS_Exported_Types STM32412G Discovery TS Exported Types 00090 * @{ 00091 */ 00092 /** 00093 * @brief TS_StateTypeDef 00094 * Define TS State structure 00095 */ 00096 typedef struct 00097 { 00098 uint8_t touchDetected; /*!< Total number of active touches detected at last scan */ 00099 uint16_t touchX[TS_MAX_NB_TOUCH]; /*!< Touch X[0], X[1] coordinates on 12 bits */ 00100 uint16_t touchY[TS_MAX_NB_TOUCH]; /*!< Touch Y[0], Y[1] coordinates on 12 bits */ 00101 00102 #if (TS_MULTI_TOUCH_SUPPORTED == 1) 00103 uint8_t touchWeight[TS_MAX_NB_TOUCH]; /*!< Touch_Weight[0], Touch_Weight[1] : weight property of touches */ 00104 uint8_t touchEventId[TS_MAX_NB_TOUCH]; /*!< Touch_EventId[0], Touch_EventId[1] : take value of type @ref TS_TouchEventTypeDef */ 00105 uint8_t touchArea[TS_MAX_NB_TOUCH]; /*!< Touch_Area[0], Touch_Area[1] : touch area of each touch */ 00106 uint32_t gestureId; /*!< type of gesture detected : take value of type @ref TS_GestureIdTypeDef */ 00107 #endif /* TS_MULTI_TOUCH_SUPPORTED == 1 */ 00108 00109 } TS_StateTypeDef; 00110 00111 /** 00112 * @brief TS_StatusTypeDef 00113 * Define BSP_TS_xxx() functions possible return value, 00114 * when status is returned by those functions. 00115 */ 00116 typedef enum 00117 { 00118 TS_OK = 0x00, /*!< Touch Ok */ 00119 TS_ERROR = 0x01, /*!< Touch Error */ 00120 TS_TIMEOUT = 0x02, /*!< Touch Timeout */ 00121 TS_DEVICE_NOT_FOUND = 0x03 /*!< Touchscreen device not found */ 00122 } TS_StatusTypeDef; 00123 00124 /** 00125 * @brief TS_GestureIdTypeDef 00126 * Define Possible managed gesture identification values returned by touch screen 00127 * driver. 00128 */ 00129 typedef enum 00130 { 00131 GEST_ID_NO_GESTURE = 0x00, /*!< Gesture not defined / recognized */ 00132 GEST_ID_MOVE_UP = 0x01, /*!< Gesture Move Up */ 00133 GEST_ID_MOVE_RIGHT = 0x02, /*!< Gesture Move Right */ 00134 GEST_ID_MOVE_DOWN = 0x03, /*!< Gesture Move Down */ 00135 GEST_ID_MOVE_LEFT = 0x04, /*!< Gesture Move Left */ 00136 GEST_ID_ZOOM_IN = 0x05, /*!< Gesture Zoom In */ 00137 GEST_ID_ZOOM_OUT = 0x06, /*!< Gesture Zoom Out */ 00138 GEST_ID_NB_MAX = 0x07 /*!< max number of gesture id */ 00139 } TS_GestureIdTypeDef; 00140 00141 /** 00142 * @brief TS_TouchEventTypeDef 00143 * Define Possible touch events kind as returned values 00144 * by touch screen IC Driver. 00145 */ 00146 typedef enum 00147 { 00148 TOUCH_EVENT_NO_EVT = 0x00, /*!< Touch Event : undetermined */ 00149 TOUCH_EVENT_PRESS_DOWN = 0x01, /*!< Touch Event Press Down */ 00150 TOUCH_EVENT_LIFT_UP = 0x02, /*!< Touch Event Lift Up */ 00151 TOUCH_EVENT_CONTACT = 0x03, /*!< Touch Event Contact */ 00152 TOUCH_EVENT_NB_MAX = 0x04 /*!< max number of touch events kind */ 00153 } TS_TouchEventTypeDef; 00154 00155 /** 00156 * @} 00157 */ 00158 00159 /** @defgroup STM32412G_DISCOVERY_TS_Imported_Variables STM32412G DISCOVERY TS Imported Variables 00160 * @{ 00161 */ 00162 /** 00163 * @brief Table for touchscreen event information display on LCD : 00164 * table indexed on enum @ref TS_TouchEventTypeDef information 00165 */ 00166 extern char * ts_event_string_tab[TOUCH_EVENT_NB_MAX]; 00167 00168 /** 00169 * @brief Table for touchscreen gesture Id information display on LCD : table indexed 00170 * on enum @ref TS_GestureIdTypeDef information 00171 */ 00172 extern char * ts_gesture_id_string_tab[GEST_ID_NB_MAX]; 00173 /** 00174 * @} 00175 */ 00176 00177 /** @defgroup STM32412G_DISCOVERY_TS_Exported_Functions STM32412G Discovery TS Exported Functions 00178 * @{ 00179 */ 00180 uint8_t BSP_TS_Init(uint16_t ts_SizeX, uint16_t ts_SizeY); 00181 uint8_t BSP_TS_InitEx(uint16_t ts_SizeX, uint16_t ts_SizeY, uint8_t orientation); 00182 uint8_t BSP_TS_GetState(TS_StateTypeDef *TS_State); 00183 00184 #if (TS_MULTI_TOUCH_SUPPORTED == 1) 00185 uint8_t BSP_TS_Get_GestureId(TS_StateTypeDef *TS_State); 00186 uint8_t BSP_TS_ResetTouchData(TS_StateTypeDef *TS_State); 00187 #endif /* TS_MULTI_TOUCH_SUPPORTED == 1 */ 00188 00189 uint8_t BSP_TS_ITConfig(void); 00190 00191 /* These __weak function can be surcharged by application code in case the current settings 00192 need to be changed for specific (example GPIO allocation) */ 00193 void BSP_TS_INT_MspInit(void); 00194 00195 /** 00196 * @} 00197 */ 00198 00199 /** 00200 * @} 00201 */ 00202 00203 /** 00204 * @} 00205 */ 00206 00207 /** 00208 * @} 00209 */ 00210 00211 00212 #ifdef __cplusplus 00213 } 00214 #endif 00215 00216 #endif /* __STM32412G_DISCOVERY_TS_H */ 00217 00218 /************************ (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