mbed official / mbed-dev

mbed library sources. Supersedes mbed-src.

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

targets/TARGET_STM/TARGET_STM32F0/device/stm32f0xx_hal_tsc.c@149:156823d33999, 2016-10-28 (annotated)

Committer:
<>
Date:
Fri Oct 28 11:17:30 2016 +0100
Revision:
149:156823d33999
Parent:
targets/cmsis/TARGET_STM/TARGET_STM32F0/stm32f0xx_hal_tsc.c@144:ef7eb2e8f9f7
Child:
156:95d6b41a828b
This updates the lib to the mbed lib v128



NOTE: This release includes a restructuring of the file and directory locations and thus some

include paths in your code may need updating accordingly.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 144:ef7eb2e8f9f7 1 /**
<> 144:ef7eb2e8f9f7 2 ******************************************************************************
<> 144:ef7eb2e8f9f7 3 * @file stm32f0xx_hal_tsc.c
<> 144:ef7eb2e8f9f7 4 * @author MCD Application Team
<> 144:ef7eb2e8f9f7 5 * @version V1.4.0
<> 144:ef7eb2e8f9f7 6 * @date 27-May-2016
<> 144:ef7eb2e8f9f7 7 * @brief This file provides firmware functions to manage the following
<> 144:ef7eb2e8f9f7 8 * functionalities of the Touch Sensing Controller (TSC) peripheral:
<> 144:ef7eb2e8f9f7 9 * + Initialization and DeInitialization
<> 144:ef7eb2e8f9f7 10 * + Channel IOs, Shield IOs and Sampling IOs configuration
<> 144:ef7eb2e8f9f7 11 * + Start and Stop an acquisition
<> 144:ef7eb2e8f9f7 12 * + Read acquisition result
<> 144:ef7eb2e8f9f7 13 * + Interrupts and flags management
<> 144:ef7eb2e8f9f7 14 *
<> 144:ef7eb2e8f9f7 15 @verbatim
<> 144:ef7eb2e8f9f7 16 ================================================================================
<> 144:ef7eb2e8f9f7 17 ##### TSC specific features #####
<> 144:ef7eb2e8f9f7 18 ================================================================================
<> 144:ef7eb2e8f9f7 19 [..]
<> 144:ef7eb2e8f9f7 20 (+) Proven and robust surface charge transfer acquisition principle
<> 144:ef7eb2e8f9f7 21
<> 144:ef7eb2e8f9f7 22 (+) Supports up to 3 capacitive sensing channels per group
<> 144:ef7eb2e8f9f7 23
<> 144:ef7eb2e8f9f7 24 (+) Capacitive sensing channels can be acquired in parallel offering a very good
<> 144:ef7eb2e8f9f7 25 response time
<> 144:ef7eb2e8f9f7 26
<> 144:ef7eb2e8f9f7 27 (+) Spread spectrum feature to improve system robustness in noisy environments
<> 144:ef7eb2e8f9f7 28
<> 144:ef7eb2e8f9f7 29 (+) Full hardware management of the charge transfer acquisition sequence
<> 144:ef7eb2e8f9f7 30
<> 144:ef7eb2e8f9f7 31 (+) Programmable charge transfer frequency
<> 144:ef7eb2e8f9f7 32
<> 144:ef7eb2e8f9f7 33 (+) Programmable sampling capacitor I/O pin
<> 144:ef7eb2e8f9f7 34
<> 144:ef7eb2e8f9f7 35 (+) Programmable channel I/O pin
<> 144:ef7eb2e8f9f7 36
<> 144:ef7eb2e8f9f7 37 (+) Programmable max count value to avoid long acquisition when a channel is faulty
<> 144:ef7eb2e8f9f7 38
<> 144:ef7eb2e8f9f7 39 (+) Dedicated end of acquisition and max count error flags with interrupt capability
<> 144:ef7eb2e8f9f7 40
<> 144:ef7eb2e8f9f7 41 (+) One sampling capacitor for up to 3 capacitive sensing channels to reduce the system
<> 144:ef7eb2e8f9f7 42 components
<> 144:ef7eb2e8f9f7 43 (+) Compatible with proximity, touchkey, linear and rotary touch sensor implementation
<> 144:ef7eb2e8f9f7 44
<> 144:ef7eb2e8f9f7 45 ##### How to use this driver #####
<> 144:ef7eb2e8f9f7 46 ================================================================================
<> 144:ef7eb2e8f9f7 47 [..]
<> 144:ef7eb2e8f9f7 48 (#) Enable the TSC interface clock using __HAL_RCC_TSC_CLK_ENABLE() macro.
<> 144:ef7eb2e8f9f7 49
<> 144:ef7eb2e8f9f7 50 (#) GPIO pins configuration
<> 144:ef7eb2e8f9f7 51 (++) Enable the clock for the TSC GPIOs using __HAL_RCC_GPIOx_CLK_ENABLE() macro.
<> 144:ef7eb2e8f9f7 52 (++) Configure the TSC pins used as sampling IOs in alternate function output Open-Drain mode,
<> 144:ef7eb2e8f9f7 53 and TSC pins used as channel/shield IOs in alternate function output Push-Pull mode
<> 144:ef7eb2e8f9f7 54 using HAL_GPIO_Init() function.
<> 144:ef7eb2e8f9f7 55 (++) Configure the alternate function on all the TSC pins using HAL_xxxx() function.
<> 144:ef7eb2e8f9f7 56
<> 144:ef7eb2e8f9f7 57 (#) Interrupts configuration
<> 144:ef7eb2e8f9f7 58 (++) Configure the NVIC (if the interrupt model is used) using HAL_xxx() function.
<> 144:ef7eb2e8f9f7 59
<> 144:ef7eb2e8f9f7 60 (#) TSC configuration
<> 144:ef7eb2e8f9f7 61 (++) Configure all TSC parameters and used TSC IOs using HAL_TSC_Init() function.
<> 144:ef7eb2e8f9f7 62
<> 144:ef7eb2e8f9f7 63 *** Acquisition sequence ***
<> 144:ef7eb2e8f9f7 64 ===================================
<> 144:ef7eb2e8f9f7 65 [..]
<> 144:ef7eb2e8f9f7 66 (+) Discharge all IOs using HAL_TSC_IODischarge() function.
<> 144:ef7eb2e8f9f7 67 (+) Wait a certain time allowing a good discharge of all capacitors. This delay depends
<> 144:ef7eb2e8f9f7 68 of the sampling capacitor and electrodes design.
<> 144:ef7eb2e8f9f7 69 (+) Select the channel IOs to be acquired using HAL_TSC_IOConfig() function.
<> 144:ef7eb2e8f9f7 70 (+) Launch the acquisition using either HAL_TSC_Start() or HAL_TSC_Start_IT() function.
<> 144:ef7eb2e8f9f7 71 If the synchronized mode is selected, the acquisition will start as soon as the signal
<> 144:ef7eb2e8f9f7 72 is received on the synchro pin.
<> 144:ef7eb2e8f9f7 73 (+) Wait the end of acquisition using either HAL_TSC_PollForAcquisition() or
<> 144:ef7eb2e8f9f7 74 HAL_TSC_GetState() function or using WFI instruction for example.
<> 144:ef7eb2e8f9f7 75 (+) Check the group acquisition status using HAL_TSC_GroupGetStatus() function.
<> 144:ef7eb2e8f9f7 76 (+) Read the acquisition value using HAL_TSC_GroupGetValue() function.
<> 144:ef7eb2e8f9f7 77
<> 144:ef7eb2e8f9f7 78 @endverbatim
<> 144:ef7eb2e8f9f7 79 ******************************************************************************
<> 144:ef7eb2e8f9f7 80 * @attention
<> 144:ef7eb2e8f9f7 81 *
<> 144:ef7eb2e8f9f7 82 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
<> 144:ef7eb2e8f9f7 83 *
<> 144:ef7eb2e8f9f7 84 * Redistribution and use in source and binary forms, with or without modification,
<> 144:ef7eb2e8f9f7 85 * are permitted provided that the following conditions are met:
<> 144:ef7eb2e8f9f7 86 * 1. Redistributions of source code must retain the above copyright notice,
<> 144:ef7eb2e8f9f7 87 * this list of conditions and the following disclaimer.
<> 144:ef7eb2e8f9f7 88 * 2. Redistributions in binary form must reproduce the above copyright notice,
<> 144:ef7eb2e8f9f7 89 * this list of conditions and the following disclaimer in the documentation
<> 144:ef7eb2e8f9f7 90 * and/or other materials provided with the distribution.
<> 144:ef7eb2e8f9f7 91 * 3. Neither the name of STMicroelectronics nor the names of its contributors
<> 144:ef7eb2e8f9f7 92 * may be used to endorse or promote products derived from this software
<> 144:ef7eb2e8f9f7 93 * without specific prior written permission.
<> 144:ef7eb2e8f9f7 94 *
<> 144:ef7eb2e8f9f7 95 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
<> 144:ef7eb2e8f9f7 96 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
<> 144:ef7eb2e8f9f7 97 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
<> 144:ef7eb2e8f9f7 98 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
<> 144:ef7eb2e8f9f7 99 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
<> 144:ef7eb2e8f9f7 100 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
<> 144:ef7eb2e8f9f7 101 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
<> 144:ef7eb2e8f9f7 102 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
<> 144:ef7eb2e8f9f7 103 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
<> 144:ef7eb2e8f9f7 104 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<> 144:ef7eb2e8f9f7 105 *
<> 144:ef7eb2e8f9f7 106 ******************************************************************************
<> 144:ef7eb2e8f9f7 107 */
<> 144:ef7eb2e8f9f7 108
<> 144:ef7eb2e8f9f7 109 /* Includes ------------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 110 #include "stm32f0xx_hal.h"
<> 144:ef7eb2e8f9f7 111
<> 144:ef7eb2e8f9f7 112 #ifdef HAL_TSC_MODULE_ENABLED
<> 144:ef7eb2e8f9f7 113
<> 144:ef7eb2e8f9f7 114 #if defined(STM32F051x8) || defined(STM32F071xB) || defined(STM32F091xC) || \
<> 144:ef7eb2e8f9f7 115 defined(STM32F042x6) || defined(STM32F072xB) || \
<> 144:ef7eb2e8f9f7 116 defined(STM32F048xx) || defined(STM32F058xx) || defined(STM32F078xx) || defined(STM32F098xx)
<> 144:ef7eb2e8f9f7 117
<> 144:ef7eb2e8f9f7 118 /** @addtogroup STM32F0xx_HAL_Driver
<> 144:ef7eb2e8f9f7 119 * @{
<> 144:ef7eb2e8f9f7 120 */
<> 144:ef7eb2e8f9f7 121
<> 144:ef7eb2e8f9f7 122 /** @defgroup TSC TSC
<> 144:ef7eb2e8f9f7 123 * @brief TSC HAL module driver
<> 144:ef7eb2e8f9f7 124 * @{
<> 144:ef7eb2e8f9f7 125 */
<> 144:ef7eb2e8f9f7 126
<> 144:ef7eb2e8f9f7 127 /* Private typedef -----------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 128 /* Private define ------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 129 /* Private macro -------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 130 /* Private variables ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 131 /* Private function prototypes -----------------------------------------------*/
<> 144:ef7eb2e8f9f7 132 static uint32_t TSC_extract_groups(uint32_t iomask);
<> 144:ef7eb2e8f9f7 133 /* Exported functions ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 134
<> 144:ef7eb2e8f9f7 135 /** @defgroup TSC_Exported_Functions TSC Exported Functions
<> 144:ef7eb2e8f9f7 136 * @{
<> 144:ef7eb2e8f9f7 137 */
<> 144:ef7eb2e8f9f7 138
<> 144:ef7eb2e8f9f7 139 /** @defgroup TSC_Exported_Functions_Group1 Initialization/de-initialization functions
<> 144:ef7eb2e8f9f7 140 * @brief Initialization and Configuration functions
<> 144:ef7eb2e8f9f7 141 *
<> 144:ef7eb2e8f9f7 142 @verbatim
<> 144:ef7eb2e8f9f7 143 ===============================================================================
<> 144:ef7eb2e8f9f7 144 ##### Initialization and de-initialization functions #####
<> 144:ef7eb2e8f9f7 145 ===============================================================================
<> 144:ef7eb2e8f9f7 146 [..] This section provides functions allowing to:
<> 144:ef7eb2e8f9f7 147 (+) Initialize and configure the TSC.
<> 144:ef7eb2e8f9f7 148 (+) De-initialize the TSC.
<> 144:ef7eb2e8f9f7 149 @endverbatim
<> 144:ef7eb2e8f9f7 150 * @{
<> 144:ef7eb2e8f9f7 151 */
<> 144:ef7eb2e8f9f7 152
<> 144:ef7eb2e8f9f7 153 /**
<> 144:ef7eb2e8f9f7 154 * @brief Initializes the TSC peripheral according to the specified parameters
<> 144:ef7eb2e8f9f7 155 * in the TSC_InitTypeDef structure.
<> 144:ef7eb2e8f9f7 156 * @param htsc: TSC handle
<> 144:ef7eb2e8f9f7 157 * @retval HAL status
<> 144:ef7eb2e8f9f7 158 */
<> 144:ef7eb2e8f9f7 159 HAL_StatusTypeDef HAL_TSC_Init(TSC_HandleTypeDef* htsc)
<> 144:ef7eb2e8f9f7 160 {
<> 144:ef7eb2e8f9f7 161 /* Check TSC handle allocation */
<> 144:ef7eb2e8f9f7 162 if (htsc == NULL)
<> 144:ef7eb2e8f9f7 163 {
<> 144:ef7eb2e8f9f7 164 return HAL_ERROR;
<> 144:ef7eb2e8f9f7 165 }
<> 144:ef7eb2e8f9f7 166
<> 144:ef7eb2e8f9f7 167 /* Check the parameters */
<> 144:ef7eb2e8f9f7 168 assert_param(IS_TSC_ALL_INSTANCE(htsc->Instance));
<> 144:ef7eb2e8f9f7 169 assert_param(IS_TSC_CTPH(htsc->Init.CTPulseHighLength));
<> 144:ef7eb2e8f9f7 170 assert_param(IS_TSC_CTPL(htsc->Init.CTPulseLowLength));
<> 144:ef7eb2e8f9f7 171 assert_param(IS_TSC_SS(htsc->Init.SpreadSpectrum));
<> 144:ef7eb2e8f9f7 172 assert_param(IS_TSC_SSD(htsc->Init.SpreadSpectrumDeviation));
<> 144:ef7eb2e8f9f7 173 assert_param(IS_TSC_SS_PRESC(htsc->Init.SpreadSpectrumPrescaler));
<> 144:ef7eb2e8f9f7 174 assert_param(IS_TSC_PG_PRESC(htsc->Init.PulseGeneratorPrescaler));
<> 144:ef7eb2e8f9f7 175 assert_param(IS_TSC_MCV(htsc->Init.MaxCountValue));
<> 144:ef7eb2e8f9f7 176 assert_param(IS_TSC_IODEF(htsc->Init.IODefaultMode));
<> 144:ef7eb2e8f9f7 177 assert_param(IS_TSC_SYNC_POL(htsc->Init.SynchroPinPolarity));
<> 144:ef7eb2e8f9f7 178 assert_param(IS_TSC_ACQ_MODE(htsc->Init.AcquisitionMode));
<> 144:ef7eb2e8f9f7 179 assert_param(IS_TSC_MCE_IT(htsc->Init.MaxCountInterrupt));
<> 144:ef7eb2e8f9f7 180
<> 144:ef7eb2e8f9f7 181 if(htsc->State == HAL_TSC_STATE_RESET)
<> 144:ef7eb2e8f9f7 182 {
<> 144:ef7eb2e8f9f7 183 /* Allocate lock resource and initialize it */
<> 144:ef7eb2e8f9f7 184 htsc->Lock = HAL_UNLOCKED;
<> 144:ef7eb2e8f9f7 185 }
<> 144:ef7eb2e8f9f7 186
<> 144:ef7eb2e8f9f7 187 /* Initialize the TSC state */
<> 144:ef7eb2e8f9f7 188 htsc->State = HAL_TSC_STATE_BUSY;
<> 144:ef7eb2e8f9f7 189
<> 144:ef7eb2e8f9f7 190 /* Init the low level hardware : GPIO, CLOCK, CORTEX */
<> 144:ef7eb2e8f9f7 191 HAL_TSC_MspInit(htsc);
<> 144:ef7eb2e8f9f7 192
<> 144:ef7eb2e8f9f7 193 /*--------------------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 194 /* Set TSC parameters */
<> 144:ef7eb2e8f9f7 195
<> 144:ef7eb2e8f9f7 196 /* Enable TSC */
<> 144:ef7eb2e8f9f7 197 htsc->Instance->CR = TSC_CR_TSCE;
<> 144:ef7eb2e8f9f7 198
<> 144:ef7eb2e8f9f7 199 /* Set all functions */
<> 144:ef7eb2e8f9f7 200 htsc->Instance->CR |= (htsc->Init.CTPulseHighLength |
<> 144:ef7eb2e8f9f7 201 htsc->Init.CTPulseLowLength |
<> 144:ef7eb2e8f9f7 202 (uint32_t)(htsc->Init.SpreadSpectrumDeviation << 17) |
<> 144:ef7eb2e8f9f7 203 htsc->Init.SpreadSpectrumPrescaler |
<> 144:ef7eb2e8f9f7 204 htsc->Init.PulseGeneratorPrescaler |
<> 144:ef7eb2e8f9f7 205 htsc->Init.MaxCountValue |
<> 144:ef7eb2e8f9f7 206 htsc->Init.SynchroPinPolarity |
<> 144:ef7eb2e8f9f7 207 htsc->Init.AcquisitionMode);
<> 144:ef7eb2e8f9f7 208
<> 144:ef7eb2e8f9f7 209 /* Spread spectrum */
<> 144:ef7eb2e8f9f7 210 if (htsc->Init.SpreadSpectrum == ENABLE)
<> 144:ef7eb2e8f9f7 211 {
<> 144:ef7eb2e8f9f7 212 htsc->Instance->CR |= TSC_CR_SSE;
<> 144:ef7eb2e8f9f7 213 }
<> 144:ef7eb2e8f9f7 214
<> 144:ef7eb2e8f9f7 215 /* Disable Schmitt trigger hysteresis on all used TSC IOs */
<> 144:ef7eb2e8f9f7 216 htsc->Instance->IOHCR = (uint32_t)(~(htsc->Init.ChannelIOs | htsc->Init.ShieldIOs | htsc->Init.SamplingIOs));
<> 144:ef7eb2e8f9f7 217
<> 144:ef7eb2e8f9f7 218 /* Set channel and shield IOs */
<> 144:ef7eb2e8f9f7 219 htsc->Instance->IOCCR = (htsc->Init.ChannelIOs | htsc->Init.ShieldIOs);
<> 144:ef7eb2e8f9f7 220
<> 144:ef7eb2e8f9f7 221 /* Set sampling IOs */
<> 144:ef7eb2e8f9f7 222 htsc->Instance->IOSCR = htsc->Init.SamplingIOs;
<> 144:ef7eb2e8f9f7 223
<> 144:ef7eb2e8f9f7 224 /* Set the groups to be acquired */
<> 144:ef7eb2e8f9f7 225 htsc->Instance->IOGCSR = TSC_extract_groups(htsc->Init.ChannelIOs);
<> 144:ef7eb2e8f9f7 226
<> 144:ef7eb2e8f9f7 227 /* Clear interrupts */
<> 144:ef7eb2e8f9f7 228 htsc->Instance->IER &= (uint32_t)(~(TSC_IT_EOA | TSC_IT_MCE));
<> 144:ef7eb2e8f9f7 229
<> 144:ef7eb2e8f9f7 230 /* Clear flags */
<> 144:ef7eb2e8f9f7 231 htsc->Instance->ICR = (TSC_FLAG_EOA | TSC_FLAG_MCE);
<> 144:ef7eb2e8f9f7 232
<> 144:ef7eb2e8f9f7 233 /*--------------------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 234
<> 144:ef7eb2e8f9f7 235 /* Initialize the TSC state */
<> 144:ef7eb2e8f9f7 236 htsc->State = HAL_TSC_STATE_READY;
<> 144:ef7eb2e8f9f7 237
<> 144:ef7eb2e8f9f7 238 /* Return function status */
<> 144:ef7eb2e8f9f7 239 return HAL_OK;
<> 144:ef7eb2e8f9f7 240 }
<> 144:ef7eb2e8f9f7 241
<> 144:ef7eb2e8f9f7 242 /**
<> 144:ef7eb2e8f9f7 243 * @brief Deinitializes the TSC peripheral registers to their default reset values.
<> 144:ef7eb2e8f9f7 244 * @param htsc: TSC handle
<> 144:ef7eb2e8f9f7 245 * @retval HAL status
<> 144:ef7eb2e8f9f7 246 */
<> 144:ef7eb2e8f9f7 247 HAL_StatusTypeDef HAL_TSC_DeInit(TSC_HandleTypeDef* htsc)
<> 144:ef7eb2e8f9f7 248 {
<> 144:ef7eb2e8f9f7 249 /* Check TSC handle allocation */
<> 144:ef7eb2e8f9f7 250 if (htsc == NULL)
<> 144:ef7eb2e8f9f7 251 {
<> 144:ef7eb2e8f9f7 252 return HAL_ERROR;
<> 144:ef7eb2e8f9f7 253 }
<> 144:ef7eb2e8f9f7 254
<> 144:ef7eb2e8f9f7 255 /* Check the parameters */
<> 144:ef7eb2e8f9f7 256 assert_param(IS_TSC_ALL_INSTANCE(htsc->Instance));
<> 144:ef7eb2e8f9f7 257
<> 144:ef7eb2e8f9f7 258 /* Change TSC state */
<> 144:ef7eb2e8f9f7 259 htsc->State = HAL_TSC_STATE_BUSY;
<> 144:ef7eb2e8f9f7 260
<> 144:ef7eb2e8f9f7 261 /* DeInit the low level hardware */
<> 144:ef7eb2e8f9f7 262 HAL_TSC_MspDeInit(htsc);
<> 144:ef7eb2e8f9f7 263
<> 144:ef7eb2e8f9f7 264 /* Change TSC state */
<> 144:ef7eb2e8f9f7 265 htsc->State = HAL_TSC_STATE_RESET;
<> 144:ef7eb2e8f9f7 266
<> 144:ef7eb2e8f9f7 267 /* Process unlocked */
<> 144:ef7eb2e8f9f7 268 __HAL_UNLOCK(htsc);
<> 144:ef7eb2e8f9f7 269
<> 144:ef7eb2e8f9f7 270 /* Return function status */
<> 144:ef7eb2e8f9f7 271 return HAL_OK;
<> 144:ef7eb2e8f9f7 272 }
<> 144:ef7eb2e8f9f7 273
<> 144:ef7eb2e8f9f7 274 /**
<> 144:ef7eb2e8f9f7 275 * @brief Initializes the TSC MSP.
<> 144:ef7eb2e8f9f7 276 * @param htsc: pointer to a TSC_HandleTypeDef structure that contains
<> 144:ef7eb2e8f9f7 277 * the configuration information for the specified TSC.
<> 144:ef7eb2e8f9f7 278 * @retval None
<> 144:ef7eb2e8f9f7 279 */
<> 144:ef7eb2e8f9f7 280 __weak void HAL_TSC_MspInit(TSC_HandleTypeDef* htsc)
<> 144:ef7eb2e8f9f7 281 {
<> 144:ef7eb2e8f9f7 282 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 283 UNUSED(htsc);
<> 144:ef7eb2e8f9f7 284
<> 144:ef7eb2e8f9f7 285 /* NOTE : This function should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 286 the HAL_TSC_MspInit could be implemented in the user file.
<> 144:ef7eb2e8f9f7 287 */
<> 144:ef7eb2e8f9f7 288 }
<> 144:ef7eb2e8f9f7 289
<> 144:ef7eb2e8f9f7 290 /**
<> 144:ef7eb2e8f9f7 291 * @brief DeInitializes the TSC MSP.
<> 144:ef7eb2e8f9f7 292 * @param htsc: pointer to a TSC_HandleTypeDef structure that contains
<> 144:ef7eb2e8f9f7 293 * the configuration information for the specified TSC.
<> 144:ef7eb2e8f9f7 294 * @retval None
<> 144:ef7eb2e8f9f7 295 */
<> 144:ef7eb2e8f9f7 296 __weak void HAL_TSC_MspDeInit(TSC_HandleTypeDef* htsc)
<> 144:ef7eb2e8f9f7 297 {
<> 144:ef7eb2e8f9f7 298 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 299 UNUSED(htsc);
<> 144:ef7eb2e8f9f7 300
<> 144:ef7eb2e8f9f7 301 /* NOTE : This function should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 302 the HAL_TSC_MspDeInit could be implemented in the user file.
<> 144:ef7eb2e8f9f7 303 */
<> 144:ef7eb2e8f9f7 304 }
<> 144:ef7eb2e8f9f7 305
<> 144:ef7eb2e8f9f7 306 /**
<> 144:ef7eb2e8f9f7 307 * @}
<> 144:ef7eb2e8f9f7 308 */
<> 144:ef7eb2e8f9f7 309
<> 144:ef7eb2e8f9f7 310 /** @defgroup TSC_Exported_Functions_Group2 IO operation functions
<> 144:ef7eb2e8f9f7 311 * @brief IO operation functions
<> 144:ef7eb2e8f9f7 312 *
<> 144:ef7eb2e8f9f7 313 @verbatim
<> 144:ef7eb2e8f9f7 314 ===============================================================================
<> 144:ef7eb2e8f9f7 315 ##### IO operation functions #####
<> 144:ef7eb2e8f9f7 316 ===============================================================================
<> 144:ef7eb2e8f9f7 317 [..] This section provides functions allowing to:
<> 144:ef7eb2e8f9f7 318 (+) Start acquisition in polling mode.
<> 144:ef7eb2e8f9f7 319 (+) Start acquisition in interrupt mode.
<> 144:ef7eb2e8f9f7 320 (+) Stop conversion in polling mode.
<> 144:ef7eb2e8f9f7 321 (+) Stop conversion in interrupt mode.
<> 144:ef7eb2e8f9f7 322 (+) Get group acquisition status.
<> 144:ef7eb2e8f9f7 323 (+) Get group acquisition value.
<> 144:ef7eb2e8f9f7 324 @endverbatim
<> 144:ef7eb2e8f9f7 325 * @{
<> 144:ef7eb2e8f9f7 326 */
<> 144:ef7eb2e8f9f7 327
<> 144:ef7eb2e8f9f7 328 /**
<> 144:ef7eb2e8f9f7 329 * @brief Starts the acquisition.
<> 144:ef7eb2e8f9f7 330 * @param htsc: pointer to a TSC_HandleTypeDef structure that contains
<> 144:ef7eb2e8f9f7 331 * the configuration information for the specified TSC.
<> 144:ef7eb2e8f9f7 332 * @retval HAL status
<> 144:ef7eb2e8f9f7 333 */
<> 144:ef7eb2e8f9f7 334 HAL_StatusTypeDef HAL_TSC_Start(TSC_HandleTypeDef* htsc)
<> 144:ef7eb2e8f9f7 335 {
<> 144:ef7eb2e8f9f7 336 /* Check the parameters */
<> 144:ef7eb2e8f9f7 337 assert_param(IS_TSC_ALL_INSTANCE(htsc->Instance));
<> 144:ef7eb2e8f9f7 338
<> 144:ef7eb2e8f9f7 339 /* Process locked */
<> 144:ef7eb2e8f9f7 340 __HAL_LOCK(htsc);
<> 144:ef7eb2e8f9f7 341
<> 144:ef7eb2e8f9f7 342 /* Change TSC state */
<> 144:ef7eb2e8f9f7 343 htsc->State = HAL_TSC_STATE_BUSY;
<> 144:ef7eb2e8f9f7 344
<> 144:ef7eb2e8f9f7 345 /* Clear interrupts */
<> 144:ef7eb2e8f9f7 346 __HAL_TSC_DISABLE_IT(htsc, (TSC_IT_EOA | TSC_IT_MCE));
<> 144:ef7eb2e8f9f7 347
<> 144:ef7eb2e8f9f7 348 /* Clear flags */
<> 144:ef7eb2e8f9f7 349 __HAL_TSC_CLEAR_FLAG(htsc, (TSC_FLAG_EOA | TSC_FLAG_MCE));
<> 144:ef7eb2e8f9f7 350
<> 144:ef7eb2e8f9f7 351 /* Set touch sensing IOs not acquired to the specified IODefaultMode */
<> 144:ef7eb2e8f9f7 352 if (htsc->Init.IODefaultMode == TSC_IODEF_OUT_PP_LOW)
<> 144:ef7eb2e8f9f7 353 {
<> 144:ef7eb2e8f9f7 354 __HAL_TSC_SET_IODEF_OUTPPLOW(htsc);
<> 144:ef7eb2e8f9f7 355 }
<> 144:ef7eb2e8f9f7 356 else
<> 144:ef7eb2e8f9f7 357 {
<> 144:ef7eb2e8f9f7 358 __HAL_TSC_SET_IODEF_INFLOAT(htsc);
<> 144:ef7eb2e8f9f7 359 }
<> 144:ef7eb2e8f9f7 360
<> 144:ef7eb2e8f9f7 361 /* Launch the acquisition */
<> 144:ef7eb2e8f9f7 362 __HAL_TSC_START_ACQ(htsc);
<> 144:ef7eb2e8f9f7 363
<> 144:ef7eb2e8f9f7 364 /* Process unlocked */
<> 144:ef7eb2e8f9f7 365 __HAL_UNLOCK(htsc);
<> 144:ef7eb2e8f9f7 366
<> 144:ef7eb2e8f9f7 367 /* Return function status */
<> 144:ef7eb2e8f9f7 368 return HAL_OK;
<> 144:ef7eb2e8f9f7 369 }
<> 144:ef7eb2e8f9f7 370
<> 144:ef7eb2e8f9f7 371 /**
<> 144:ef7eb2e8f9f7 372 * @brief Enables the interrupt and starts the acquisition
<> 144:ef7eb2e8f9f7 373 * @param htsc: pointer to a TSC_HandleTypeDef structure that contains
<> 144:ef7eb2e8f9f7 374 * the configuration information for the specified TSC.
<> 144:ef7eb2e8f9f7 375 * @retval HAL status.
<> 144:ef7eb2e8f9f7 376 */
<> 144:ef7eb2e8f9f7 377 HAL_StatusTypeDef HAL_TSC_Start_IT(TSC_HandleTypeDef* htsc)
<> 144:ef7eb2e8f9f7 378 {
<> 144:ef7eb2e8f9f7 379 /* Check the parameters */
<> 144:ef7eb2e8f9f7 380 assert_param(IS_TSC_ALL_INSTANCE(htsc->Instance));
<> 144:ef7eb2e8f9f7 381 assert_param(IS_TSC_MCE_IT(htsc->Init.MaxCountInterrupt));
<> 144:ef7eb2e8f9f7 382
<> 144:ef7eb2e8f9f7 383 /* Process locked */
<> 144:ef7eb2e8f9f7 384 __HAL_LOCK(htsc);
<> 144:ef7eb2e8f9f7 385
<> 144:ef7eb2e8f9f7 386 /* Change TSC state */
<> 144:ef7eb2e8f9f7 387 htsc->State = HAL_TSC_STATE_BUSY;
<> 144:ef7eb2e8f9f7 388
<> 144:ef7eb2e8f9f7 389 /* Enable end of acquisition interrupt */
<> 144:ef7eb2e8f9f7 390 __HAL_TSC_ENABLE_IT(htsc, TSC_IT_EOA);
<> 144:ef7eb2e8f9f7 391
<> 144:ef7eb2e8f9f7 392 /* Enable max count error interrupt (optional) */
<> 144:ef7eb2e8f9f7 393 if (htsc->Init.MaxCountInterrupt == ENABLE)
<> 144:ef7eb2e8f9f7 394 {
<> 144:ef7eb2e8f9f7 395 __HAL_TSC_ENABLE_IT(htsc, TSC_IT_MCE);
<> 144:ef7eb2e8f9f7 396 }
<> 144:ef7eb2e8f9f7 397 else
<> 144:ef7eb2e8f9f7 398 {
<> 144:ef7eb2e8f9f7 399 __HAL_TSC_DISABLE_IT(htsc, TSC_IT_MCE);
<> 144:ef7eb2e8f9f7 400 }
<> 144:ef7eb2e8f9f7 401
<> 144:ef7eb2e8f9f7 402 /* Clear flags */
<> 144:ef7eb2e8f9f7 403 __HAL_TSC_CLEAR_FLAG(htsc, (TSC_FLAG_EOA | TSC_FLAG_MCE));
<> 144:ef7eb2e8f9f7 404
<> 144:ef7eb2e8f9f7 405 /* Set touch sensing IOs not acquired to the specified IODefaultMode */
<> 144:ef7eb2e8f9f7 406 if (htsc->Init.IODefaultMode == TSC_IODEF_OUT_PP_LOW)
<> 144:ef7eb2e8f9f7 407 {
<> 144:ef7eb2e8f9f7 408 __HAL_TSC_SET_IODEF_OUTPPLOW(htsc);
<> 144:ef7eb2e8f9f7 409 }
<> 144:ef7eb2e8f9f7 410 else
<> 144:ef7eb2e8f9f7 411 {
<> 144:ef7eb2e8f9f7 412 __HAL_TSC_SET_IODEF_INFLOAT(htsc);
<> 144:ef7eb2e8f9f7 413 }
<> 144:ef7eb2e8f9f7 414
<> 144:ef7eb2e8f9f7 415 /* Launch the acquisition */
<> 144:ef7eb2e8f9f7 416 __HAL_TSC_START_ACQ(htsc);
<> 144:ef7eb2e8f9f7 417
<> 144:ef7eb2e8f9f7 418 /* Process unlocked */
<> 144:ef7eb2e8f9f7 419 __HAL_UNLOCK(htsc);
<> 144:ef7eb2e8f9f7 420
<> 144:ef7eb2e8f9f7 421 /* Return function status */
<> 144:ef7eb2e8f9f7 422 return HAL_OK;
<> 144:ef7eb2e8f9f7 423 }
<> 144:ef7eb2e8f9f7 424
<> 144:ef7eb2e8f9f7 425 /**
<> 144:ef7eb2e8f9f7 426 * @brief Stops the acquisition previously launched in polling mode
<> 144:ef7eb2e8f9f7 427 * @param htsc: pointer to a TSC_HandleTypeDef structure that contains
<> 144:ef7eb2e8f9f7 428 * the configuration information for the specified TSC.
<> 144:ef7eb2e8f9f7 429 * @retval HAL status
<> 144:ef7eb2e8f9f7 430 */
<> 144:ef7eb2e8f9f7 431 HAL_StatusTypeDef HAL_TSC_Stop(TSC_HandleTypeDef* htsc)
<> 144:ef7eb2e8f9f7 432 {
<> 144:ef7eb2e8f9f7 433 /* Check the parameters */
<> 144:ef7eb2e8f9f7 434 assert_param(IS_TSC_ALL_INSTANCE(htsc->Instance));
<> 144:ef7eb2e8f9f7 435
<> 144:ef7eb2e8f9f7 436 /* Process locked */
<> 144:ef7eb2e8f9f7 437 __HAL_LOCK(htsc);
<> 144:ef7eb2e8f9f7 438
<> 144:ef7eb2e8f9f7 439 /* Stop the acquisition */
<> 144:ef7eb2e8f9f7 440 __HAL_TSC_STOP_ACQ(htsc);
<> 144:ef7eb2e8f9f7 441
<> 144:ef7eb2e8f9f7 442 /* Set touch sensing IOs in low power mode (output push-pull) */
<> 144:ef7eb2e8f9f7 443 __HAL_TSC_SET_IODEF_OUTPPLOW(htsc);
<> 144:ef7eb2e8f9f7 444
<> 144:ef7eb2e8f9f7 445 /* Clear flags */
<> 144:ef7eb2e8f9f7 446 __HAL_TSC_CLEAR_FLAG(htsc, (TSC_FLAG_EOA | TSC_FLAG_MCE));
<> 144:ef7eb2e8f9f7 447
<> 144:ef7eb2e8f9f7 448 /* Change TSC state */
<> 144:ef7eb2e8f9f7 449 htsc->State = HAL_TSC_STATE_READY;
<> 144:ef7eb2e8f9f7 450
<> 144:ef7eb2e8f9f7 451 /* Process unlocked */
<> 144:ef7eb2e8f9f7 452 __HAL_UNLOCK(htsc);
<> 144:ef7eb2e8f9f7 453
<> 144:ef7eb2e8f9f7 454 /* Return function status */
<> 144:ef7eb2e8f9f7 455 return HAL_OK;
<> 144:ef7eb2e8f9f7 456 }
<> 144:ef7eb2e8f9f7 457
<> 144:ef7eb2e8f9f7 458 /**
<> 144:ef7eb2e8f9f7 459 * @brief Stops the acquisition previously launched in interrupt mode
<> 144:ef7eb2e8f9f7 460 * @param htsc: pointer to a TSC_HandleTypeDef structure that contains
<> 144:ef7eb2e8f9f7 461 * the configuration information for the specified TSC.
<> 144:ef7eb2e8f9f7 462 * @retval HAL status
<> 144:ef7eb2e8f9f7 463 */
<> 144:ef7eb2e8f9f7 464 HAL_StatusTypeDef HAL_TSC_Stop_IT(TSC_HandleTypeDef* htsc)
<> 144:ef7eb2e8f9f7 465 {
<> 144:ef7eb2e8f9f7 466 /* Check the parameters */
<> 144:ef7eb2e8f9f7 467 assert_param(IS_TSC_ALL_INSTANCE(htsc->Instance));
<> 144:ef7eb2e8f9f7 468
<> 144:ef7eb2e8f9f7 469 /* Process locked */
<> 144:ef7eb2e8f9f7 470 __HAL_LOCK(htsc);
<> 144:ef7eb2e8f9f7 471
<> 144:ef7eb2e8f9f7 472 /* Stop the acquisition */
<> 144:ef7eb2e8f9f7 473 __HAL_TSC_STOP_ACQ(htsc);
<> 144:ef7eb2e8f9f7 474
<> 144:ef7eb2e8f9f7 475 /* Set touch sensing IOs in low power mode (output push-pull) */
<> 144:ef7eb2e8f9f7 476 __HAL_TSC_SET_IODEF_OUTPPLOW(htsc);
<> 144:ef7eb2e8f9f7 477
<> 144:ef7eb2e8f9f7 478 /* Disable interrupts */
<> 144:ef7eb2e8f9f7 479 __HAL_TSC_DISABLE_IT(htsc, (TSC_IT_EOA | TSC_IT_MCE));
<> 144:ef7eb2e8f9f7 480
<> 144:ef7eb2e8f9f7 481 /* Clear flags */
<> 144:ef7eb2e8f9f7 482 __HAL_TSC_CLEAR_FLAG(htsc, (TSC_FLAG_EOA | TSC_FLAG_MCE));
<> 144:ef7eb2e8f9f7 483
<> 144:ef7eb2e8f9f7 484 /* Change TSC state */
<> 144:ef7eb2e8f9f7 485 htsc->State = HAL_TSC_STATE_READY;
<> 144:ef7eb2e8f9f7 486
<> 144:ef7eb2e8f9f7 487 /* Process unlocked */
<> 144:ef7eb2e8f9f7 488 __HAL_UNLOCK(htsc);
<> 144:ef7eb2e8f9f7 489
<> 144:ef7eb2e8f9f7 490 /* Return function status */
<> 144:ef7eb2e8f9f7 491 return HAL_OK;
<> 144:ef7eb2e8f9f7 492 }
<> 144:ef7eb2e8f9f7 493
<> 144:ef7eb2e8f9f7 494 /**
<> 144:ef7eb2e8f9f7 495 * @brief Gets the acquisition status for a group
<> 144:ef7eb2e8f9f7 496 * @param htsc: pointer to a TSC_HandleTypeDef structure that contains
<> 144:ef7eb2e8f9f7 497 * the configuration information for the specified TSC.
<> 144:ef7eb2e8f9f7 498 * @param gx_index: Index of the group
<> 144:ef7eb2e8f9f7 499 * @retval Group status
<> 144:ef7eb2e8f9f7 500 */
<> 144:ef7eb2e8f9f7 501 TSC_GroupStatusTypeDef HAL_TSC_GroupGetStatus(TSC_HandleTypeDef* htsc, uint32_t gx_index)
<> 144:ef7eb2e8f9f7 502 {
<> 144:ef7eb2e8f9f7 503 /* Check the parameters */
<> 144:ef7eb2e8f9f7 504 assert_param(IS_TSC_ALL_INSTANCE(htsc->Instance));
<> 144:ef7eb2e8f9f7 505 assert_param(IS_GROUP_INDEX(gx_index));
<> 144:ef7eb2e8f9f7 506
<> 144:ef7eb2e8f9f7 507 /* Return the group status */
<> 144:ef7eb2e8f9f7 508 return(__HAL_TSC_GET_GROUP_STATUS(htsc, gx_index));
<> 144:ef7eb2e8f9f7 509 }
<> 144:ef7eb2e8f9f7 510
<> 144:ef7eb2e8f9f7 511 /**
<> 144:ef7eb2e8f9f7 512 * @brief Gets the acquisition measure for a group
<> 144:ef7eb2e8f9f7 513 * @param htsc: pointer to a TSC_HandleTypeDef structure that contains
<> 144:ef7eb2e8f9f7 514 * the configuration information for the specified TSC.
<> 144:ef7eb2e8f9f7 515 * @param gx_index: Index of the group
<> 144:ef7eb2e8f9f7 516 * @retval Acquisition measure
<> 144:ef7eb2e8f9f7 517 */
<> 144:ef7eb2e8f9f7 518 uint32_t HAL_TSC_GroupGetValue(TSC_HandleTypeDef* htsc, uint32_t gx_index)
<> 144:ef7eb2e8f9f7 519 {
<> 144:ef7eb2e8f9f7 520 /* Check the parameters */
<> 144:ef7eb2e8f9f7 521 assert_param(IS_TSC_ALL_INSTANCE(htsc->Instance));
<> 144:ef7eb2e8f9f7 522 assert_param(IS_GROUP_INDEX(gx_index));
<> 144:ef7eb2e8f9f7 523
<> 144:ef7eb2e8f9f7 524 /* Return the group acquisition counter */
<> 144:ef7eb2e8f9f7 525 return htsc->Instance->IOGXCR[gx_index];
<> 144:ef7eb2e8f9f7 526 }
<> 144:ef7eb2e8f9f7 527
<> 144:ef7eb2e8f9f7 528 /**
<> 144:ef7eb2e8f9f7 529 * @}
<> 144:ef7eb2e8f9f7 530 */
<> 144:ef7eb2e8f9f7 531
<> 144:ef7eb2e8f9f7 532 /** @defgroup TSC_Exported_Functions_Group3 Peripheral Control functions
<> 144:ef7eb2e8f9f7 533 * @brief Peripheral Control functions
<> 144:ef7eb2e8f9f7 534 *
<> 144:ef7eb2e8f9f7 535 @verbatim
<> 144:ef7eb2e8f9f7 536 ===============================================================================
<> 144:ef7eb2e8f9f7 537 ##### Peripheral Control functions #####
<> 144:ef7eb2e8f9f7 538 ===============================================================================
<> 144:ef7eb2e8f9f7 539 [..] This section provides functions allowing to:
<> 144:ef7eb2e8f9f7 540 (+) Configure TSC IOs
<> 144:ef7eb2e8f9f7 541 (+) Discharge TSC IOs
<> 144:ef7eb2e8f9f7 542 @endverbatim
<> 144:ef7eb2e8f9f7 543 * @{
<> 144:ef7eb2e8f9f7 544 */
<> 144:ef7eb2e8f9f7 545
<> 144:ef7eb2e8f9f7 546 /**
<> 144:ef7eb2e8f9f7 547 * @brief Configures TSC IOs
<> 144:ef7eb2e8f9f7 548 * @param htsc: pointer to a TSC_HandleTypeDef structure that contains
<> 144:ef7eb2e8f9f7 549 * the configuration information for the specified TSC.
<> 144:ef7eb2e8f9f7 550 * @param config: pointer to the configuration structure.
<> 144:ef7eb2e8f9f7 551 * @retval HAL status
<> 144:ef7eb2e8f9f7 552 */
<> 144:ef7eb2e8f9f7 553 HAL_StatusTypeDef HAL_TSC_IOConfig(TSC_HandleTypeDef* htsc, TSC_IOConfigTypeDef* config)
<> 144:ef7eb2e8f9f7 554 {
<> 144:ef7eb2e8f9f7 555 /* Check the parameters */
<> 144:ef7eb2e8f9f7 556 assert_param(IS_TSC_ALL_INSTANCE(htsc->Instance));
<> 144:ef7eb2e8f9f7 557
<> 144:ef7eb2e8f9f7 558 /* Process locked */
<> 144:ef7eb2e8f9f7 559 __HAL_LOCK(htsc);
<> 144:ef7eb2e8f9f7 560
<> 144:ef7eb2e8f9f7 561 /* Stop acquisition */
<> 144:ef7eb2e8f9f7 562 __HAL_TSC_STOP_ACQ(htsc);
<> 144:ef7eb2e8f9f7 563
<> 144:ef7eb2e8f9f7 564 /* Disable Schmitt trigger hysteresis on all used TSC IOs */
<> 144:ef7eb2e8f9f7 565 htsc->Instance->IOHCR = (uint32_t)(~(config->ChannelIOs | config->ShieldIOs | config->SamplingIOs));
<> 144:ef7eb2e8f9f7 566
<> 144:ef7eb2e8f9f7 567 /* Set channel and shield IOs */
<> 144:ef7eb2e8f9f7 568 htsc->Instance->IOCCR = (config->ChannelIOs | config->ShieldIOs);
<> 144:ef7eb2e8f9f7 569
<> 144:ef7eb2e8f9f7 570 /* Set sampling IOs */
<> 144:ef7eb2e8f9f7 571 htsc->Instance->IOSCR = config->SamplingIOs;
<> 144:ef7eb2e8f9f7 572
<> 144:ef7eb2e8f9f7 573 /* Set groups to be acquired */
<> 144:ef7eb2e8f9f7 574 htsc->Instance->IOGCSR = TSC_extract_groups(config->ChannelIOs);
<> 144:ef7eb2e8f9f7 575
<> 144:ef7eb2e8f9f7 576 /* Process unlocked */
<> 144:ef7eb2e8f9f7 577 __HAL_UNLOCK(htsc);
<> 144:ef7eb2e8f9f7 578
<> 144:ef7eb2e8f9f7 579 /* Return function status */
<> 144:ef7eb2e8f9f7 580 return HAL_OK;
<> 144:ef7eb2e8f9f7 581 }
<> 144:ef7eb2e8f9f7 582
<> 144:ef7eb2e8f9f7 583 /**
<> 144:ef7eb2e8f9f7 584 * @brief Discharge TSC IOs
<> 144:ef7eb2e8f9f7 585 * @param htsc: pointer to a TSC_HandleTypeDef structure that contains
<> 144:ef7eb2e8f9f7 586 * the configuration information for the specified TSC.
<> 144:ef7eb2e8f9f7 587 * @param choice: enable or disable
<> 144:ef7eb2e8f9f7 588 * @retval HAL status
<> 144:ef7eb2e8f9f7 589 */
<> 144:ef7eb2e8f9f7 590 HAL_StatusTypeDef HAL_TSC_IODischarge(TSC_HandleTypeDef* htsc, uint32_t choice)
<> 144:ef7eb2e8f9f7 591 {
<> 144:ef7eb2e8f9f7 592 /* Check the parameters */
<> 144:ef7eb2e8f9f7 593 assert_param(IS_TSC_ALL_INSTANCE(htsc->Instance));
<> 144:ef7eb2e8f9f7 594
<> 144:ef7eb2e8f9f7 595 /* Process locked */
<> 144:ef7eb2e8f9f7 596 __HAL_LOCK(htsc);
<> 144:ef7eb2e8f9f7 597
<> 144:ef7eb2e8f9f7 598 if (choice == ENABLE)
<> 144:ef7eb2e8f9f7 599 {
<> 144:ef7eb2e8f9f7 600 __HAL_TSC_SET_IODEF_OUTPPLOW(htsc);
<> 144:ef7eb2e8f9f7 601 }
<> 144:ef7eb2e8f9f7 602 else
<> 144:ef7eb2e8f9f7 603 {
<> 144:ef7eb2e8f9f7 604 __HAL_TSC_SET_IODEF_INFLOAT(htsc);
<> 144:ef7eb2e8f9f7 605 }
<> 144:ef7eb2e8f9f7 606
<> 144:ef7eb2e8f9f7 607 /* Process unlocked */
<> 144:ef7eb2e8f9f7 608 __HAL_UNLOCK(htsc);
<> 144:ef7eb2e8f9f7 609
<> 144:ef7eb2e8f9f7 610 /* Return the group acquisition counter */
<> 144:ef7eb2e8f9f7 611 return HAL_OK;
<> 144:ef7eb2e8f9f7 612 }
<> 144:ef7eb2e8f9f7 613
<> 144:ef7eb2e8f9f7 614 /**
<> 144:ef7eb2e8f9f7 615 * @}
<> 144:ef7eb2e8f9f7 616 */
<> 144:ef7eb2e8f9f7 617
<> 144:ef7eb2e8f9f7 618 /** @defgroup TSC_Exported_Functions_Group4 State functions
<> 144:ef7eb2e8f9f7 619 * @brief State functions
<> 144:ef7eb2e8f9f7 620 *
<> 144:ef7eb2e8f9f7 621 @verbatim
<> 144:ef7eb2e8f9f7 622 ===============================================================================
<> 144:ef7eb2e8f9f7 623 ##### State functions #####
<> 144:ef7eb2e8f9f7 624 ===============================================================================
<> 144:ef7eb2e8f9f7 625 [..]
<> 144:ef7eb2e8f9f7 626 This subsection provides functions allowing to
<> 144:ef7eb2e8f9f7 627 (+) Get TSC state.
<> 144:ef7eb2e8f9f7 628 (+) Poll for acquisition completed.
<> 144:ef7eb2e8f9f7 629 (+) Handles TSC interrupt request.
<> 144:ef7eb2e8f9f7 630
<> 144:ef7eb2e8f9f7 631 @endverbatim
<> 144:ef7eb2e8f9f7 632 * @{
<> 144:ef7eb2e8f9f7 633 */
<> 144:ef7eb2e8f9f7 634
<> 144:ef7eb2e8f9f7 635 /**
<> 144:ef7eb2e8f9f7 636 * @brief Return the TSC state
<> 144:ef7eb2e8f9f7 637 * @param htsc: pointer to a TSC_HandleTypeDef structure that contains
<> 144:ef7eb2e8f9f7 638 * the configuration information for the specified TSC.
<> 144:ef7eb2e8f9f7 639 * @retval HAL state
<> 144:ef7eb2e8f9f7 640 */
<> 144:ef7eb2e8f9f7 641 HAL_TSC_StateTypeDef HAL_TSC_GetState(TSC_HandleTypeDef* htsc)
<> 144:ef7eb2e8f9f7 642 {
<> 144:ef7eb2e8f9f7 643 /* Check the parameters */
<> 144:ef7eb2e8f9f7 644 assert_param(IS_TSC_ALL_INSTANCE(htsc->Instance));
<> 144:ef7eb2e8f9f7 645
<> 144:ef7eb2e8f9f7 646 if (htsc->State == HAL_TSC_STATE_BUSY)
<> 144:ef7eb2e8f9f7 647 {
<> 144:ef7eb2e8f9f7 648 /* Check end of acquisition flag */
<> 144:ef7eb2e8f9f7 649 if (__HAL_TSC_GET_FLAG(htsc, TSC_FLAG_EOA) != RESET)
<> 144:ef7eb2e8f9f7 650 {
<> 144:ef7eb2e8f9f7 651 /* Check max count error flag */
<> 144:ef7eb2e8f9f7 652 if (__HAL_TSC_GET_FLAG(htsc, TSC_FLAG_MCE) != RESET)
<> 144:ef7eb2e8f9f7 653 {
<> 144:ef7eb2e8f9f7 654 /* Change TSC state */
<> 144:ef7eb2e8f9f7 655 htsc->State = HAL_TSC_STATE_ERROR;
<> 144:ef7eb2e8f9f7 656 }
<> 144:ef7eb2e8f9f7 657 else
<> 144:ef7eb2e8f9f7 658 {
<> 144:ef7eb2e8f9f7 659 /* Change TSC state */
<> 144:ef7eb2e8f9f7 660 htsc->State = HAL_TSC_STATE_READY;
<> 144:ef7eb2e8f9f7 661 }
<> 144:ef7eb2e8f9f7 662 }
<> 144:ef7eb2e8f9f7 663 }
<> 144:ef7eb2e8f9f7 664
<> 144:ef7eb2e8f9f7 665 /* Return TSC state */
<> 144:ef7eb2e8f9f7 666 return htsc->State;
<> 144:ef7eb2e8f9f7 667 }
<> 144:ef7eb2e8f9f7 668
<> 144:ef7eb2e8f9f7 669 /**
<> 144:ef7eb2e8f9f7 670 * @brief Start acquisition and wait until completion
<> 144:ef7eb2e8f9f7 671 * @note There is no need of a timeout parameter as the max count error is already
<> 144:ef7eb2e8f9f7 672 * managed by the TSC peripheral.
<> 144:ef7eb2e8f9f7 673 * @param htsc: pointer to a TSC_HandleTypeDef structure that contains
<> 144:ef7eb2e8f9f7 674 * the configuration information for the specified TSC.
<> 144:ef7eb2e8f9f7 675 * @retval HAL state
<> 144:ef7eb2e8f9f7 676 */
<> 144:ef7eb2e8f9f7 677 HAL_StatusTypeDef HAL_TSC_PollForAcquisition(TSC_HandleTypeDef* htsc)
<> 144:ef7eb2e8f9f7 678 {
<> 144:ef7eb2e8f9f7 679 /* Check the parameters */
<> 144:ef7eb2e8f9f7 680 assert_param(IS_TSC_ALL_INSTANCE(htsc->Instance));
<> 144:ef7eb2e8f9f7 681
<> 144:ef7eb2e8f9f7 682 /* Process locked */
<> 144:ef7eb2e8f9f7 683 __HAL_LOCK(htsc);
<> 144:ef7eb2e8f9f7 684
<> 144:ef7eb2e8f9f7 685 /* Check end of acquisition */
<> 144:ef7eb2e8f9f7 686 while (HAL_TSC_GetState(htsc) == HAL_TSC_STATE_BUSY)
<> 144:ef7eb2e8f9f7 687 {
<> 144:ef7eb2e8f9f7 688 /* The timeout (max count error) is managed by the TSC peripheral itself. */
<> 144:ef7eb2e8f9f7 689 }
<> 144:ef7eb2e8f9f7 690
<> 144:ef7eb2e8f9f7 691 /* Process unlocked */
<> 144:ef7eb2e8f9f7 692 __HAL_UNLOCK(htsc);
<> 144:ef7eb2e8f9f7 693
<> 144:ef7eb2e8f9f7 694 return HAL_OK;
<> 144:ef7eb2e8f9f7 695 }
<> 144:ef7eb2e8f9f7 696
<> 144:ef7eb2e8f9f7 697 /**
<> 144:ef7eb2e8f9f7 698 * @brief Handles TSC interrupt request
<> 144:ef7eb2e8f9f7 699 * @param htsc: pointer to a TSC_HandleTypeDef structure that contains
<> 144:ef7eb2e8f9f7 700 * the configuration information for the specified TSC.
<> 144:ef7eb2e8f9f7 701 * @retval None
<> 144:ef7eb2e8f9f7 702 */
<> 144:ef7eb2e8f9f7 703 void HAL_TSC_IRQHandler(TSC_HandleTypeDef* htsc)
<> 144:ef7eb2e8f9f7 704 {
<> 144:ef7eb2e8f9f7 705 /* Check the parameters */
<> 144:ef7eb2e8f9f7 706 assert_param(IS_TSC_ALL_INSTANCE(htsc->Instance));
<> 144:ef7eb2e8f9f7 707
<> 144:ef7eb2e8f9f7 708 /* Check if the end of acquisition occured */
<> 144:ef7eb2e8f9f7 709 if (__HAL_TSC_GET_FLAG(htsc, TSC_FLAG_EOA) != RESET)
<> 144:ef7eb2e8f9f7 710 {
<> 144:ef7eb2e8f9f7 711 /* Clear EOA flag */
<> 144:ef7eb2e8f9f7 712 __HAL_TSC_CLEAR_FLAG(htsc, TSC_FLAG_EOA);
<> 144:ef7eb2e8f9f7 713 }
<> 144:ef7eb2e8f9f7 714
<> 144:ef7eb2e8f9f7 715 /* Check if max count error occured */
<> 144:ef7eb2e8f9f7 716 if (__HAL_TSC_GET_FLAG(htsc, TSC_FLAG_MCE) != RESET)
<> 144:ef7eb2e8f9f7 717 {
<> 144:ef7eb2e8f9f7 718 /* Clear MCE flag */
<> 144:ef7eb2e8f9f7 719 __HAL_TSC_CLEAR_FLAG(htsc, TSC_FLAG_MCE);
<> 144:ef7eb2e8f9f7 720 /* Change TSC state */
<> 144:ef7eb2e8f9f7 721 htsc->State = HAL_TSC_STATE_ERROR;
<> 144:ef7eb2e8f9f7 722 /* Conversion completed callback */
<> 144:ef7eb2e8f9f7 723 HAL_TSC_ErrorCallback(htsc);
<> 144:ef7eb2e8f9f7 724 }
<> 144:ef7eb2e8f9f7 725 else
<> 144:ef7eb2e8f9f7 726 {
<> 144:ef7eb2e8f9f7 727 /* Change TSC state */
<> 144:ef7eb2e8f9f7 728 htsc->State = HAL_TSC_STATE_READY;
<> 144:ef7eb2e8f9f7 729 /* Conversion completed callback */
<> 144:ef7eb2e8f9f7 730 HAL_TSC_ConvCpltCallback(htsc);
<> 144:ef7eb2e8f9f7 731 }
<> 144:ef7eb2e8f9f7 732 }
<> 144:ef7eb2e8f9f7 733
<> 144:ef7eb2e8f9f7 734 /**
<> 144:ef7eb2e8f9f7 735 * @}
<> 144:ef7eb2e8f9f7 736 */
<> 144:ef7eb2e8f9f7 737
<> 144:ef7eb2e8f9f7 738 /** @defgroup TSC_Exported_Functions_Group5 Callback functions
<> 144:ef7eb2e8f9f7 739 * @brief Callback functions
<> 144:ef7eb2e8f9f7 740 * @{
<> 144:ef7eb2e8f9f7 741 */
<> 144:ef7eb2e8f9f7 742
<> 144:ef7eb2e8f9f7 743 /**
<> 144:ef7eb2e8f9f7 744 * @brief Acquisition completed callback in non blocking mode
<> 144:ef7eb2e8f9f7 745 * @param htsc: pointer to a TSC_HandleTypeDef structure that contains
<> 144:ef7eb2e8f9f7 746 * the configuration information for the specified TSC.
<> 144:ef7eb2e8f9f7 747 * @retval None
<> 144:ef7eb2e8f9f7 748 */
<> 144:ef7eb2e8f9f7 749 __weak void HAL_TSC_ConvCpltCallback(TSC_HandleTypeDef* htsc)
<> 144:ef7eb2e8f9f7 750 {
<> 144:ef7eb2e8f9f7 751 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 752 UNUSED(htsc);
<> 144:ef7eb2e8f9f7 753
<> 144:ef7eb2e8f9f7 754 /* NOTE : This function should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 755 the HAL_TSC_ConvCpltCallback could be implemented in the user file.
<> 144:ef7eb2e8f9f7 756 */
<> 144:ef7eb2e8f9f7 757 }
<> 144:ef7eb2e8f9f7 758
<> 144:ef7eb2e8f9f7 759 /**
<> 144:ef7eb2e8f9f7 760 * @brief Error callback in non blocking mode
<> 144:ef7eb2e8f9f7 761 * @param htsc: pointer to a TSC_HandleTypeDef structure that contains
<> 144:ef7eb2e8f9f7 762 * the configuration information for the specified TSC.
<> 144:ef7eb2e8f9f7 763 * @retval None
<> 144:ef7eb2e8f9f7 764 */
<> 144:ef7eb2e8f9f7 765 __weak void HAL_TSC_ErrorCallback(TSC_HandleTypeDef* htsc)
<> 144:ef7eb2e8f9f7 766 {
<> 144:ef7eb2e8f9f7 767 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 768 UNUSED(htsc);
<> 144:ef7eb2e8f9f7 769
<> 144:ef7eb2e8f9f7 770 /* NOTE : This function should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 771 the HAL_TSC_ErrorCallback could be implemented in the user file.
<> 144:ef7eb2e8f9f7 772 */
<> 144:ef7eb2e8f9f7 773 }
<> 144:ef7eb2e8f9f7 774
<> 144:ef7eb2e8f9f7 775 /**
<> 144:ef7eb2e8f9f7 776 * @}
<> 144:ef7eb2e8f9f7 777 */
<> 144:ef7eb2e8f9f7 778
<> 144:ef7eb2e8f9f7 779 /**
<> 144:ef7eb2e8f9f7 780 * @}
<> 144:ef7eb2e8f9f7 781 */
<> 144:ef7eb2e8f9f7 782
<> 144:ef7eb2e8f9f7 783 /** @defgroup TSC_Private_Functions TSC Private Functions
<> 144:ef7eb2e8f9f7 784 * @{
<> 144:ef7eb2e8f9f7 785 */
<> 144:ef7eb2e8f9f7 786
<> 144:ef7eb2e8f9f7 787 /**
<> 144:ef7eb2e8f9f7 788 * @brief Utility function used to set the acquired groups mask
<> 144:ef7eb2e8f9f7 789 * @param iomask: Channels IOs mask
<> 144:ef7eb2e8f9f7 790 * @retval Acquired groups mask
<> 144:ef7eb2e8f9f7 791 */
<> 144:ef7eb2e8f9f7 792 static uint32_t TSC_extract_groups(uint32_t iomask)
<> 144:ef7eb2e8f9f7 793 {
<> 144:ef7eb2e8f9f7 794 uint32_t groups = 0;
<> 144:ef7eb2e8f9f7 795 uint32_t idx;
<> 144:ef7eb2e8f9f7 796
<> 144:ef7eb2e8f9f7 797 for (idx = 0; idx < TSC_NB_OF_GROUPS; idx++)
<> 144:ef7eb2e8f9f7 798 {
<> 144:ef7eb2e8f9f7 799 if ((iomask & ((uint32_t)0x0F << (idx * 4))) != RESET)
<> 144:ef7eb2e8f9f7 800 {
<> 144:ef7eb2e8f9f7 801 groups |= ((uint32_t)1 << idx);
<> 144:ef7eb2e8f9f7 802 }
<> 144:ef7eb2e8f9f7 803 }
<> 144:ef7eb2e8f9f7 804
<> 144:ef7eb2e8f9f7 805 return groups;
<> 144:ef7eb2e8f9f7 806 }
<> 144:ef7eb2e8f9f7 807
<> 144:ef7eb2e8f9f7 808 /**
<> 144:ef7eb2e8f9f7 809 * @}
<> 144:ef7eb2e8f9f7 810 */
<> 144:ef7eb2e8f9f7 811
<> 144:ef7eb2e8f9f7 812 /**
<> 144:ef7eb2e8f9f7 813 * @}
<> 144:ef7eb2e8f9f7 814 */
<> 144:ef7eb2e8f9f7 815
<> 144:ef7eb2e8f9f7 816 /**
<> 144:ef7eb2e8f9f7 817 * @}
<> 144:ef7eb2e8f9f7 818 */
<> 144:ef7eb2e8f9f7 819
<> 144:ef7eb2e8f9f7 820 #endif /* defined(STM32F051x8) || defined(STM32F071xB) || defined(STM32F091xC) || */
<> 144:ef7eb2e8f9f7 821 /* defined(STM32F042x6) || defined(STM32F072xB) || */
<> 144:ef7eb2e8f9f7 822 /* defined(STM32F048xx) || defined(STM32F058xx) || defined(STM32F078xx) || defined(STM32F098xx) */
<> 144:ef7eb2e8f9f7 823
<> 144:ef7eb2e8f9f7 824 #endif /* HAL_TSC_MODULE_ENABLED */
<> 144:ef7eb2e8f9f7 825
<> 144:ef7eb2e8f9f7 826 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/