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