tool/mbed/mbed-sdk/libraries/mbed/targets/cmsis/TARGET_STM/TARGET_STM32F3/stm32f3xx_hal_tsc.h

   1 /**
   2   ******************************************************************************
   3   * @file    stm32f3xx_hal_tsc.h
   4   * @author  MCD Application Team
   5   * @version V1.1.0
   6   * @date    12-Sept-2014
   7   * @brief   This file contains all the functions prototypes for the TSC firmware
   8   *          library.
   9   ******************************************************************************
  10   * @attention
  11   *
  12   * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
  13   *
  14   * Redistribution and use in source and binary forms, with or without modification,
  15   * are permitted provided that the following conditions are met:
  16   *   1. Redistributions of source code must retain the above copyright notice,
  17   *      this list of conditions and the following disclaimer.
  18   *   2. Redistributions in binary form must reproduce the above copyright notice,
  19   *      this list of conditions and the following disclaimer in the documentation
  20   *      and/or other materials provided with the distribution.
  21   *   3. Neither the name of STMicroelectronics nor the names of its contributors
  22   *      may be used to endorse or promote products derived from this software
  23   *      without specific prior written permission.
  24   *
  25   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  26   * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  27   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  28   * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  29   * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  30   * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  31   * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  32   * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  33   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  34   * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  35   *
  36   ******************************************************************************
  37   */
  38
  39 /* Define to prevent recursive inclusion -------------------------------------*/
  40 #ifndef __STM32F3xx_TSC_H
  41 #define __STM32F3xx_TSC_H
  42
  43 #ifdef __cplusplus
  44  extern "C" {
  45 #endif
  46
  47 /* Includes ------------------------------------------------------------------*/
  48 #include "stm32f3xx_hal_def.h"
  49
  50 /** @addtogroup STM32F3xx_HAL_Driver
  51   * @{
  52   */
  53
  54 /** @addtogroup TSC
  55   * @{
  56   */
  57
  58 /* Exported types ------------------------------------------------------------*/
  59
  60 /** @defgroup TSC_Exported_Types TSC Exported Types
  61   * @{
  62   */
  63 /**
  64   * @brief TSC state structure definition
  65   */
  66 typedef enum
  67 {
  68   HAL_TSC_STATE_RESET  = 0x00, /*!< TSC registers have their reset value */
  69   HAL_TSC_STATE_READY  = 0x01, /*!< TSC registers are initialized or acquisition is completed with success */
  70   HAL_TSC_STATE_BUSY   = 0x02, /*!< TSC initialization or acquisition is on-going */
  71   HAL_TSC_STATE_ERROR  = 0x03  /*!< Acquisition is completed with max count error */
  72 } HAL_TSC_StateTypeDef;
  73
  74 /**
  75   * @brief TSC group status structure definition
  76   */
  77 typedef enum
  78 {
  79   TSC_GROUP_ONGOING   = 0x00, /*!< Acquisition on group is on-going or not started */
  80   TSC_GROUP_COMPLETED = 0x01  /*!< Acquisition on group is completed with success (no max count error) */
  81 } TSC_GroupStatusTypeDef;
  82
  83 /**
  84   * @brief TSC init structure definition
  85   */
  86 typedef struct
  87 {
  88   uint32_t CTPulseHighLength;       /*!< Charge-transfer high pulse length */
  89   uint32_t CTPulseLowLength;        /*!< Charge-transfer low pulse length */
  90   uint32_t SpreadSpectrum;          /*!< Spread spectrum activation */
  91   uint32_t SpreadSpectrumDeviation; /*!< Spread spectrum deviation */
  92   uint32_t SpreadSpectrumPrescaler; /*!< Spread spectrum prescaler */
  93   uint32_t PulseGeneratorPrescaler; /*!< Pulse generator prescaler */
  94   uint32_t MaxCountValue;           /*!< Max count value */
  95   uint32_t IODefaultMode;           /*!< IO default mode */
  96   uint32_t SynchroPinPolarity;      /*!< Synchro pin polarity */
  97   uint32_t AcquisitionMode;         /*!< Acquisition mode */
  98   uint32_t MaxCountInterrupt;       /*!< Max count interrupt activation */
  99   uint32_t ChannelIOs;              /*!< Channel IOs mask */
 100   uint32_t ShieldIOs;               /*!< Shield IOs mask */
 101   uint32_t SamplingIOs;             /*!< Sampling IOs mask */
 102 } TSC_InitTypeDef;
 103
 104 /**
 105   * @brief TSC IOs configuration structure definition
 106   */
 107 typedef struct
 108 {
 109   uint32_t ChannelIOs;  /*!< Channel IOs mask */
 110   uint32_t ShieldIOs;   /*!< Shield IOs mask */
 111   uint32_t SamplingIOs; /*!< Sampling IOs mask */
 112 } TSC_IOConfigTypeDef;
 113
 114 /**
 115   * @brief  TSC handle Structure definition
 116   */
 117 typedef struct
 118 {
 119   TSC_TypeDef               *Instance; /*!< Register base address */
 120   TSC_InitTypeDef           Init;      /*!< Initialization parameters */
 121   __IO HAL_TSC_StateTypeDef State;     /*!< Peripheral state */
 122   HAL_LockTypeDef           Lock;      /*!< Lock feature */
 123 } TSC_HandleTypeDef;
 124
 125 /**
 126   * @}
 127   */
 128
 129 /* Exported constants --------------------------------------------------------*/
 130
 131 /** @defgroup TSC_Exported_Constants TSC Exported Constants
 132   * @{
 133   */
 134
 135 #define TSC_CTPH_1CYCLE   ((uint32_t)((uint32_t) 0 << 28))
 136 #define TSC_CTPH_2CYCLES  ((uint32_t)((uint32_t) 1 << 28))
 137 #define TSC_CTPH_3CYCLES  ((uint32_t)((uint32_t) 2 << 28))
 138 #define TSC_CTPH_4CYCLES  ((uint32_t)((uint32_t) 3 << 28))
 139 #define TSC_CTPH_5CYCLES  ((uint32_t)((uint32_t) 4 << 28))
 140 #define TSC_CTPH_6CYCLES  ((uint32_t)((uint32_t) 5 << 28))
 141 #define TSC_CTPH_7CYCLES  ((uint32_t)((uint32_t) 6 << 28))
 142 #define TSC_CTPH_8CYCLES  ((uint32_t)((uint32_t) 7 << 28))
 143 #define TSC_CTPH_9CYCLES  ((uint32_t)((uint32_t) 8 << 28))
 144 #define TSC_CTPH_10CYCLES ((uint32_t)((uint32_t) 9 << 28))
 145 #define TSC_CTPH_11CYCLES ((uint32_t)((uint32_t)10 << 28))
 146 #define TSC_CTPH_12CYCLES ((uint32_t)((uint32_t)11 << 28))
 147 #define TSC_CTPH_13CYCLES ((uint32_t)((uint32_t)12 << 28))
 148 #define TSC_CTPH_14CYCLES ((uint32_t)((uint32_t)13 << 28))
 149 #define TSC_CTPH_15CYCLES ((uint32_t)((uint32_t)14 << 28))
 150 #define TSC_CTPH_16CYCLES ((uint32_t)((uint32_t)15 << 28))
 151 #define IS_TSC_CTPH(VAL) (((VAL) == TSC_CTPH_1CYCLE) || \
 152                           ((VAL) == TSC_CTPH_2CYCLES) || \
 153                           ((VAL) == TSC_CTPH_3CYCLES) || \
 154                           ((VAL) == TSC_CTPH_4CYCLES) || \
 155                           ((VAL) == TSC_CTPH_5CYCLES) || \
 156                           ((VAL) == TSC_CTPH_6CYCLES) || \
 157                           ((VAL) == TSC_CTPH_7CYCLES) || \
 158                           ((VAL) == TSC_CTPH_8CYCLES) || \
 159                           ((VAL) == TSC_CTPH_9CYCLES) || \
 160                           ((VAL) == TSC_CTPH_10CYCLES) || \
 161                           ((VAL) == TSC_CTPH_11CYCLES) || \
 162                           ((VAL) == TSC_CTPH_12CYCLES) || \
 163                           ((VAL) == TSC_CTPH_13CYCLES) || \
 164                           ((VAL) == TSC_CTPH_14CYCLES) || \
 165                           ((VAL) == TSC_CTPH_15CYCLES) || \
 166                           ((VAL) == TSC_CTPH_16CYCLES))
 167
 168 #define TSC_CTPL_1CYCLE   ((uint32_t)((uint32_t) 0 << 24))
 169 #define TSC_CTPL_2CYCLES  ((uint32_t)((uint32_t) 1 << 24))
 170 #define TSC_CTPL_3CYCLES  ((uint32_t)((uint32_t) 2 << 24))
 171 #define TSC_CTPL_4CYCLES  ((uint32_t)((uint32_t) 3 << 24))
 172 #define TSC_CTPL_5CYCLES  ((uint32_t)((uint32_t) 4 << 24))
 173 #define TSC_CTPL_6CYCLES  ((uint32_t)((uint32_t) 5 << 24))
 174 #define TSC_CTPL_7CYCLES  ((uint32_t)((uint32_t) 6 << 24))
 175 #define TSC_CTPL_8CYCLES  ((uint32_t)((uint32_t) 7 << 24))
 176 #define TSC_CTPL_9CYCLES  ((uint32_t)((uint32_t) 8 << 24))
 177 #define TSC_CTPL_10CYCLES ((uint32_t)((uint32_t) 9 << 24))
 178 #define TSC_CTPL_11CYCLES ((uint32_t)((uint32_t)10 << 24))
 179 #define TSC_CTPL_12CYCLES ((uint32_t)((uint32_t)11 << 24))
 180 #define TSC_CTPL_13CYCLES ((uint32_t)((uint32_t)12 << 24))
 181 #define TSC_CTPL_14CYCLES ((uint32_t)((uint32_t)13 << 24))
 182 #define TSC_CTPL_15CYCLES ((uint32_t)((uint32_t)14 << 24))
 183 #define TSC_CTPL_16CYCLES ((uint32_t)((uint32_t)15 << 24))
 184 #define IS_TSC_CTPL(VAL) (((VAL) == TSC_CTPL_1CYCLE) || \
 185                           ((VAL) == TSC_CTPL_2CYCLES) || \
 186                           ((VAL) == TSC_CTPL_3CYCLES) || \
 187                           ((VAL) == TSC_CTPL_4CYCLES) || \
 188                           ((VAL) == TSC_CTPL_5CYCLES) || \
 189                           ((VAL) == TSC_CTPL_6CYCLES) || \
 190                           ((VAL) == TSC_CTPL_7CYCLES) || \
 191                           ((VAL) == TSC_CTPL_8CYCLES) || \
 192                           ((VAL) == TSC_CTPL_9CYCLES) || \
 193                           ((VAL) == TSC_CTPL_10CYCLES) || \
 194                           ((VAL) == TSC_CTPL_11CYCLES) || \
 195                           ((VAL) == TSC_CTPL_12CYCLES) || \
 196                           ((VAL) == TSC_CTPL_13CYCLES) || \
 197                           ((VAL) == TSC_CTPL_14CYCLES) || \
 198                           ((VAL) == TSC_CTPL_15CYCLES) || \
 199                           ((VAL) == TSC_CTPL_16CYCLES))
 200
 201 #define IS_TSC_SS(VAL) (((VAL) == DISABLE) || ((VAL) == ENABLE))
 202
 203 #define IS_TSC_SSD(VAL) (((VAL) == 0) || (((VAL) > 0) && ((VAL) < 128)))
 204
 205 #define TSC_SS_PRESC_DIV1 ((uint32_t)0)
 206 #define TSC_SS_PRESC_DIV2  (TSC_CR_SSPSC)
 207 #define IS_TSC_SS_PRESC(VAL) (((VAL) == TSC_SS_PRESC_DIV1) || ((VAL) == TSC_SS_PRESC_DIV2))
 208
 209 #define TSC_PG_PRESC_DIV1   ((uint32_t)(0 << 12))
 210 #define TSC_PG_PRESC_DIV2   ((uint32_t)(1 << 12))
 211 #define TSC_PG_PRESC_DIV4   ((uint32_t)(2 << 12))
 212 #define TSC_PG_PRESC_DIV8   ((uint32_t)(3 << 12))
 213 #define TSC_PG_PRESC_DIV16  ((uint32_t)(4 << 12))
 214 #define TSC_PG_PRESC_DIV32  ((uint32_t)(5 << 12))
 215 #define TSC_PG_PRESC_DIV64  ((uint32_t)(6 << 12))
 216 #define TSC_PG_PRESC_DIV128 ((uint32_t)(7 << 12))
 217 #define IS_TSC_PG_PRESC(VAL) (((VAL) == TSC_PG_PRESC_DIV1) || \
 218                               ((VAL) == TSC_PG_PRESC_DIV2) || \
 219                               ((VAL) == TSC_PG_PRESC_DIV4) || \
 220                               ((VAL) == TSC_PG_PRESC_DIV8) || \
 221                               ((VAL) == TSC_PG_PRESC_DIV16) || \
 222                               ((VAL) == TSC_PG_PRESC_DIV32) || \
 223                               ((VAL) == TSC_PG_PRESC_DIV64) || \
 224                               ((VAL) == TSC_PG_PRESC_DIV128))
 225
 226 #define TSC_MCV_255   ((uint32_t)(0 << 5))
 227 #define TSC_MCV_511   ((uint32_t)(1 << 5))
 228 #define TSC_MCV_1023  ((uint32_t)(2 << 5))
 229 #define TSC_MCV_2047  ((uint32_t)(3 << 5))
 230 #define TSC_MCV_4095  ((uint32_t)(4 << 5))
 231 #define TSC_MCV_8191  ((uint32_t)(5 << 5))
 232 #define TSC_MCV_16383 ((uint32_t)(6 << 5))
 233 #define IS_TSC_MCV(VAL) (((VAL) == TSC_MCV_255) || \
 234                          ((VAL) == TSC_MCV_511) || \
 235                          ((VAL) == TSC_MCV_1023) || \
 236                          ((VAL) == TSC_MCV_2047) || \
 237                          ((VAL) == TSC_MCV_4095) || \
 238                          ((VAL) == TSC_MCV_8191) || \
 239                          ((VAL) == TSC_MCV_16383))
 240
 241 #define TSC_IODEF_OUT_PP_LOW ((uint32_t)0)
 242 #define TSC_IODEF_IN_FLOAT   (TSC_CR_IODEF)
 243 #define IS_TSC_IODEF(VAL) (((VAL) == TSC_IODEF_OUT_PP_LOW) || ((VAL) == TSC_IODEF_IN_FLOAT))
 244
 245 #define TSC_SYNC_POL_FALL      ((uint32_t)0)
 246 #define TSC_SYNC_POL_RISE_HIGH (TSC_CR_SYNCPOL)
 247 #define IS_TSC_SYNC_POL(VAL) (((VAL) == TSC_SYNC_POL_FALL) || ((VAL) == TSC_SYNC_POL_RISE_HIGH))
 248
 249 #define TSC_ACQ_MODE_NORMAL  ((uint32_t)0)
 250 #define TSC_ACQ_MODE_SYNCHRO (TSC_CR_AM)
 251 #define IS_TSC_ACQ_MODE(VAL) (((VAL) == TSC_ACQ_MODE_NORMAL) || ((VAL) == TSC_ACQ_MODE_SYNCHRO))
 252
 253 #define TSC_IOMODE_UNUSED   ((uint32_t)0)
 254 #define TSC_IOMODE_CHANNEL  ((uint32_t)1)
 255 #define TSC_IOMODE_SHIELD   ((uint32_t)2)
 256 #define TSC_IOMODE_SAMPLING ((uint32_t)3)
 257 #define IS_TSC_IOMODE(VAL) (((VAL) == TSC_IOMODE_UNUSED) || \
 258                             ((VAL) == TSC_IOMODE_CHANNEL) || \
 259                             ((VAL) == TSC_IOMODE_SHIELD) || \
 260                             ((VAL) == TSC_IOMODE_SAMPLING))
 261
 262 /** @defgroup TSC_interrupts_definition TSC interrupts definition
 263   * @{
 264   */
 265 #define TSC_IT_EOA ((uint32_t)TSC_IER_EOAIE)
 266 #define TSC_IT_MCE ((uint32_t)TSC_IER_MCEIE)
 267 #define IS_TSC_MCE_IT(VAL) (((VAL) == DISABLE) || ((VAL) == ENABLE))
 268 /**
 269   * @}
 270   */
 271
 272 /** @defgroup TSC_flags_definition TSC Flags Definition
 273   * @{
 274   */
 275 #define TSC_FLAG_EOA ((uint32_t)TSC_ISR_EOAF)
 276 #define TSC_FLAG_MCE ((uint32_t)TSC_ISR_MCEF)
 277 /**
 278   * @}
 279   */
 280
 281 #define TSC_NB_OF_GROUPS (8)
 282
 283 #define TSC_GROUP1 ((uint32_t)0x00000001)
 284 #define TSC_GROUP2 ((uint32_t)0x00000002)
 285 #define TSC_GROUP3 ((uint32_t)0x00000004)
 286 #define TSC_GROUP4 ((uint32_t)0x00000008)
 287 #define TSC_GROUP5 ((uint32_t)0x00000010)
 288 #define TSC_GROUP6 ((uint32_t)0x00000020)
 289 #define TSC_GROUP7 ((uint32_t)0x00000040)
 290 #define TSC_GROUP8 ((uint32_t)0x00000080)
 291 #define TSC_ALL_GROUPS ((uint32_t)0x000000FF)
 292
 293 #define TSC_GROUP1_IDX ((uint32_t)0)
 294 #define TSC_GROUP2_IDX ((uint32_t)1)
 295 #define TSC_GROUP3_IDX ((uint32_t)2)
 296 #define TSC_GROUP4_IDX ((uint32_t)3)
 297 #define TSC_GROUP5_IDX ((uint32_t)4)
 298 #define TSC_GROUP6_IDX ((uint32_t)5)
 299 #define TSC_GROUP7_IDX ((uint32_t)6)
 300 #define TSC_GROUP8_IDX ((uint32_t)7)
 301 #define IS_GROUP_INDEX(VAL) (((VAL) == 0) || (((VAL) > 0) && ((VAL) < TSC_NB_OF_GROUPS)))
 302
 303 #define TSC_GROUP1_IO1 ((uint32_t)0x00000001)
 304 #define TSC_GROUP1_IO2 ((uint32_t)0x00000002)
 305 #define TSC_GROUP1_IO3 ((uint32_t)0x00000004)
 306 #define TSC_GROUP1_IO4 ((uint32_t)0x00000008)
 307 #define TSC_GROUP1_ALL_IOS ((uint32_t)0x0000000F)
 308
 309 #define TSC_GROUP2_IO1 ((uint32_t)0x00000010)
 310 #define TSC_GROUP2_IO2 ((uint32_t)0x00000020)
 311 #define TSC_GROUP2_IO3 ((uint32_t)0x00000040)
 312 #define TSC_GROUP2_IO4 ((uint32_t)0x00000080)
 313 #define TSC_GROUP2_ALL_IOS ((uint32_t)0x000000F0)
 314
 315 #define TSC_GROUP3_IO1 ((uint32_t)0x00000100)
 316 #define TSC_GROUP3_IO2 ((uint32_t)0x00000200)
 317 #define TSC_GROUP3_IO3 ((uint32_t)0x00000400)
 318 #define TSC_GROUP3_IO4 ((uint32_t)0x00000800)
 319 #define TSC_GROUP3_ALL_IOS ((uint32_t)0x00000F00)
 320
 321 #define TSC_GROUP4_IO1 ((uint32_t)0x00001000)
 322 #define TSC_GROUP4_IO2 ((uint32_t)0x00002000)
 323 #define TSC_GROUP4_IO3 ((uint32_t)0x00004000)
 324 #define TSC_GROUP4_IO4 ((uint32_t)0x00008000)
 325 #define TSC_GROUP4_ALL_IOS ((uint32_t)0x0000F000)
 326
 327 #define TSC_GROUP5_IO1 ((uint32_t)0x00010000)
 328 #define TSC_GROUP5_IO2 ((uint32_t)0x00020000)
 329 #define TSC_GROUP5_IO3 ((uint32_t)0x00040000)
 330 #define TSC_GROUP5_IO4 ((uint32_t)0x00080000)
 331 #define TSC_GROUP5_ALL_IOS ((uint32_t)0x000F0000)
 332
 333 #define TSC_GROUP6_IO1 ((uint32_t)0x00100000)
 334 #define TSC_GROUP6_IO2 ((uint32_t)0x00200000)
 335 #define TSC_GROUP6_IO3 ((uint32_t)0x00400000)
 336 #define TSC_GROUP6_IO4 ((uint32_t)0x00800000)
 337 #define TSC_GROUP6_ALL_IOS ((uint32_t)0x00F00000)
 338
 339 #define TSC_GROUP7_IO1 ((uint32_t)0x01000000)
 340 #define TSC_GROUP7_IO2 ((uint32_t)0x02000000)
 341 #define TSC_GROUP7_IO3 ((uint32_t)0x04000000)
 342 #define TSC_GROUP7_IO4 ((uint32_t)0x08000000)
 343 #define TSC_GROUP7_ALL_IOS ((uint32_t)0x0F000000)
 344
 345 #define TSC_GROUP8_IO1 ((uint32_t)0x10000000)
 346 #define TSC_GROUP8_IO2 ((uint32_t)0x20000000)
 347 #define TSC_GROUP8_IO3 ((uint32_t)0x40000000)
 348 #define TSC_GROUP8_IO4 ((uint32_t)0x80000000)
 349 #define TSC_GROUP8_ALL_IOS ((uint32_t)0xF0000000)
 350
 351 #define TSC_ALL_GROUPS_ALL_IOS ((uint32_t)0xFFFFFFFF)
 352
 353 /**
 354   * @}
 355   */
 356
 357 /* Exported macros -----------------------------------------------------------*/
 358 /** @defgroup TSC_Exported_Macros TSC Exported Macros
 359  * @{
 360  */
 361
 362 /** @brief  Reset TSC handle state
 363   * @param  __HANDLE__: TSC handle.
 364   * @retval None
 365   */
 366 #define __HAL_TSC_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_TSC_STATE_RESET)
 367
 368 /**
 369   * @brief Enable the TSC peripheral.
 370   * @param  __HANDLE__: TSC handle
 371   * @retval None
 372   */
 373 #define __HAL_TSC_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= TSC_CR_TSCE)
 374
 375 /**
 376   * @brief Disable the TSC peripheral.
 377   * @param  __HANDLE__: TSC handle
 378   * @retval None
 379   */
 380 #define __HAL_TSC_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR &= (uint32_t)(~TSC_CR_TSCE))
 381
 382 /**
 383   * @brief Start acquisition
 384   * @param  __HANDLE__: TSC handle
 385   * @retval None
 386   */
 387 #define __HAL_TSC_START_ACQ(__HANDLE__) ((__HANDLE__)->Instance->CR |= TSC_CR_START)
 388
 389 /**
 390   * @brief Stop acquisition
 391   * @param  __HANDLE__: TSC handle
 392   * @retval None
 393   */
 394 #define __HAL_TSC_STOP_ACQ(__HANDLE__) ((__HANDLE__)->Instance->CR &= (uint32_t)(~TSC_CR_START))
 395
 396 /**
 397   * @brief Set IO default mode to output push-pull low
 398   * @param  __HANDLE__: TSC handle
 399   * @retval None
 400   */
 401 #define __HAL_TSC_SET_IODEF_OUTPPLOW(__HANDLE__) ((__HANDLE__)->Instance->CR &= (uint32_t)(~TSC_CR_IODEF))
 402
 403 /**
 404   * @brief Set IO default mode to input floating
 405   * @param  __HANDLE__: TSC handle
 406   * @retval None
 407   */
 408 #define __HAL_TSC_SET_IODEF_INFLOAT(__HANDLE__) ((__HANDLE__)->Instance->CR |= TSC_CR_IODEF)
 409
 410 /**
 411   * @brief Set synchronization polarity to falling edge
 412   * @param  __HANDLE__: TSC handle
 413   * @retval None
 414   */
 415 #define __HAL_TSC_SET_SYNC_POL_FALL(__HANDLE__) ((__HANDLE__)->Instance->CR &= (uint32_t)(~TSC_CR_SYNCPOL))
 416
 417 /**
 418   * @brief Set synchronization polarity to rising edge and high level
 419   * @param  __HANDLE__: TSC handle
 420   * @retval None
 421   */
 422 #define __HAL_TSC_SET_SYNC_POL_RISE_HIGH(__HANDLE__) ((__HANDLE__)->Instance->CR |= TSC_CR_SYNCPOL)
 423
 424 /**
 425   * @brief Enable TSC interrupt.
 426   * @param  __HANDLE__: TSC handle
 427   * @param  __INTERRUPT__: TSC interrupt
 428   * @retval None
 429   */
 430 #define __HAL_TSC_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->IER |= (__INTERRUPT__))
 431
 432 /**
 433   * @brief Disable TSC interrupt.
 434   * @param  __HANDLE__: TSC handle
 435   * @param  __INTERRUPT__: TSC interrupt
 436   * @retval None
 437   */
 438 #define __HAL_TSC_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->IER &= (uint32_t)(~(__INTERRUPT__)))
 439
 440 /** @brief Check if the specified TSC interrupt source is enabled or disabled.
 441   * @param  __HANDLE__: TSC Handle
 442   * @param  __INTERRUPT__: TSC interrupt
 443   * @retval SET or RESET
 444   */
 445 #define __HAL_TSC_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((__HANDLE__)->Instance->IER & (__INTERRUPT__)) == (__INTERRUPT__)) ? SET : RESET)
 446
 447 /**
 448   * @brief Get the selected TSC's flag status.
 449   * @param  __HANDLE__: TSC handle
 450   * @param  __FLAG__: TSC flag
 451   * @retval SET or RESET
 452   */
 453 #define __HAL_TSC_GET_FLAG(__HANDLE__, __FLAG__) ((((__HANDLE__)->Instance->ISR & (__FLAG__)) == (__FLAG__)) ? SET : RESET)
 454
 455 /**
 456   * @brief Clear the TSC's pending flag.
 457   * @param  __HANDLE__: TSC handle
 458   * @param  __FLAG__: TSC flag
 459   * @retval None
 460   */
 461 #define __HAL_TSC_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ICR = (__FLAG__))
 462
 463 /**
 464   * @brief Enable schmitt trigger hysteresis on a group of IOs
 465   * @param  __HANDLE__: TSC handle
 466   * @param  __GX_IOY_MASK__: IOs mask
 467   * @retval None
 468   */
 469 #define __HAL_TSC_ENABLE_HYSTERESIS(__HANDLE__, __GX_IOY_MASK__) ((__HANDLE__)->Instance->IOHCR |= (__GX_IOY_MASK__))
 470
 471 /**
 472   * @brief Disable schmitt trigger hysteresis on a group of IOs
 473   * @param  __HANDLE__: TSC handle
 474   * @param  __GX_IOY_MASK__: IOs mask
 475   * @retval None
 476   */
 477 #define __HAL_TSC_DISABLE_HYSTERESIS(__HANDLE__, __GX_IOY_MASK__) ((__HANDLE__)->Instance->IOHCR &= (uint32_t)(~(__GX_IOY_MASK__)))
 478
 479 /**
 480   * @brief Open analog switch on a group of IOs
 481   * @param  __HANDLE__: TSC handle
 482   * @param  __GX_IOY_MASK__: IOs mask
 483   * @retval None
 484   */
 485 #define __HAL_TSC_OPEN_ANALOG_SWITCH(__HANDLE__, __GX_IOY_MASK__) ((__HANDLE__)->Instance->IOASCR &= (uint32_t)(~(__GX_IOY_MASK__)))
 486
 487 /**
 488   * @brief Close analog switch on a group of IOs
 489   * @param  __HANDLE__: TSC handle
 490   * @param  __GX_IOY_MASK__: IOs mask
 491   * @retval None
 492   */
 493 #define __HAL_TSC_CLOSE_ANALOG_SWITCH(__HANDLE__, __GX_IOY_MASK__) ((__HANDLE__)->Instance->IOASCR |= (__GX_IOY_MASK__))
 494
 495 /**
 496   * @brief Enable a group of IOs in channel mode
 497   * @param  __HANDLE__: TSC handle
 498   * @param  __GX_IOY_MASK__: IOs mask
 499   * @retval None
 500   */
 501 #define __HAL_TSC_ENABLE_CHANNEL(__HANDLE__, __GX_IOY_MASK__) ((__HANDLE__)->Instance->IOCCR |= (__GX_IOY_MASK__))
 502
 503 /**
 504   * @brief Disable a group of channel IOs
 505   * @param  __HANDLE__: TSC handle
 506   * @param  __GX_IOY_MASK__: IOs mask
 507   * @retval None
 508   */
 509 #define __HAL_TSC_DISABLE_CHANNEL(__HANDLE__, __GX_IOY_MASK__) ((__HANDLE__)->Instance->IOCCR &= (uint32_t)(~(__GX_IOY_MASK__)))
 510
 511 /**
 512   * @brief Enable a group of IOs in sampling mode
 513   * @param  __HANDLE__: TSC handle
 514   * @param  __GX_IOY_MASK__: IOs mask
 515   * @retval None
 516   */
 517 #define __HAL_TSC_ENABLE_SAMPLING(__HANDLE__, __GX_IOY_MASK__) ((__HANDLE__)->Instance->IOSCR |= (__GX_IOY_MASK__))
 518
 519 /**
 520   * @brief Disable a group of sampling IOs
 521   * @param  __HANDLE__: TSC handle
 522   * @param  __GX_IOY_MASK__: IOs mask
 523   * @retval None
 524   */
 525 #define __HAL_TSC_DISABLE_SAMPLING(__HANDLE__, __GX_IOY_MASK__) ((__HANDLE__)->Instance->IOSCR &= (uint32_t)(~(__GX_IOY_MASK__)))
 526
 527 /**
 528   * @brief Enable acquisition groups
 529   * @param  __HANDLE__: TSC handle
 530   * @param  __GX_MASK__: Groups mask
 531   * @retval None
 532   */
 533 #define __HAL_TSC_ENABLE_GROUP(__HANDLE__, __GX_MASK__) ((__HANDLE__)->Instance->IOGCSR |= (__GX_MASK__))
 534
 535 /**
 536   * @brief Disable acquisition groups
 537   * @param  __HANDLE__: TSC handle
 538   * @param  __GX_MASK__: Groups mask
 539   * @retval None
 540   */
 541 #define __HAL_TSC_DISABLE_GROUP(__HANDLE__, __GX_MASK__) ((__HANDLE__)->Instance->IOGCSR &= (uint32_t)(~(__GX_MASK__)))
 542
 543 /** @brief Gets acquisition group status
 544   * @param  __HANDLE__: TSC Handle
 545   * @param  __GX_INDEX__: Group index
 546   * @retval SET or RESET
 547   */
 548 #define __HAL_TSC_GET_GROUP_STATUS(__HANDLE__, __GX_INDEX__) \
 549 ((((__HANDLE__)->Instance->IOGCSR & (uint32_t)((uint32_t)1 << ((__GX_INDEX__) + (uint32_t)16))) == (uint32_t)((uint32_t)1 << ((__GX_INDEX__) + (uint32_t)16))) ? TSC_GROUP_COMPLETED : TSC_GROUP_ONGOING)
 550
 551 /**
 552   * @}
 553   */
 554
 555 /* Exported functions --------------------------------------------------------*/
 556 /** @addtogroup TSC_Exported_Functions TSC Exported Functions
 557   * @{
 558   */
 559
 560 /** @addtogroup TSC_Exported_Functions_Group1 Initialization and de-initialization functions
 561  *  @brief    Initialization and Configuration functions
 562  *  @{
 563  */
 564  /* Initialization and de-initialization functions *****************************/
 565 HAL_StatusTypeDef HAL_TSC_Init(TSC_HandleTypeDef* htsc);
 566 HAL_StatusTypeDef HAL_TSC_DeInit(TSC_HandleTypeDef *htsc);
 567 void HAL_TSC_MspInit(TSC_HandleTypeDef* htsc);
 568 void HAL_TSC_MspDeInit(TSC_HandleTypeDef* htsc);
 569 /**
 570   * @}
 571   */
 572
 573 /** @addtogroup TSC_Exported_Functions_Group2 Input and Output operation functions
 574  *  @brief    IO operation functions
 575  *  @{
 576  */
 577 /* IO operation functions *****************************************************/
 578 HAL_StatusTypeDef HAL_TSC_Start(TSC_HandleTypeDef* htsc);
 579 HAL_StatusTypeDef HAL_TSC_Start_IT(TSC_HandleTypeDef* htsc);
 580 HAL_StatusTypeDef HAL_TSC_Stop(TSC_HandleTypeDef* htsc);
 581 HAL_StatusTypeDef HAL_TSC_Stop_IT(TSC_HandleTypeDef* htsc);
 582 TSC_GroupStatusTypeDef HAL_TSC_GroupGetStatus(TSC_HandleTypeDef* htsc, uint32_t gx_index);
 583 uint32_t HAL_TSC_GroupGetValue(TSC_HandleTypeDef* htsc, uint32_t gx_index);
 584 /**
 585   * @}
 586   */
 587
 588 /** @addtogroup TSC_Exported_Functions_Group3 Peripheral Control functions
 589  *  @brief    Peripheral Control functions
 590  *  @{
 591  */
 592 /* Peripheral Control functions ***********************************************/
 593 HAL_StatusTypeDef HAL_TSC_IOConfig(TSC_HandleTypeDef* htsc, TSC_IOConfigTypeDef* config);
 594 HAL_StatusTypeDef HAL_TSC_IODischarge(TSC_HandleTypeDef* htsc, uint32_t choice);
 595 /**
 596   * @}
 597   */
 598
 599 /** @addtogroup TSC_Exported_Functions_Group4 Peripheral State functions
 600  *  @brief   State functions
 601  *  @{
 602  */
 603 /* Peripheral State and Error functions ***************************************/
 604 HAL_TSC_StateTypeDef HAL_TSC_GetState(TSC_HandleTypeDef* htsc);
 605 HAL_StatusTypeDef HAL_TSC_PollForAcquisition(TSC_HandleTypeDef* htsc);
 606 void HAL_TSC_IRQHandler(TSC_HandleTypeDef* htsc);
 607 /**
 608   * @}
 609   */
 610
 611
 612 /* Callback functions *********************************************************/
 613 void HAL_TSC_ConvCpltCallback(TSC_HandleTypeDef* htsc);
 614 void HAL_TSC_ErrorCallback(TSC_HandleTypeDef* htsc);
 615 /**
 616   * @}
 617   */
 618
 619 /**
 620   * @}
 621   */
 622
 623 /**
 624   * @}
 625   */
 626
 627 #ifdef __cplusplus
 628 }
 629 #endif
 630
 631 #endif /*__STM32F3xx_TSC_H */
 632
 633 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/