Lancaster University / mbed-src

Lancaster University's (short term!) clone of mbed-src for micro:bit. This is a copy of the github branch https://github.com/lancaster-university/mbed-classic

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32L4/stm32l4xx_hal_tsc.c@610:813dcc80987e, 2015-08-14 (annotated)

Committer:
mbed_official
Date:
Fri Aug 14 13:15:17 2015 +0100
Revision:
610:813dcc80987e
Synchronized with git revision 6d84db41c6833e0b9b024741eb0616a5f62d5599



Full URL: https://github.com/mbedmicro/mbed/commit/6d84db41c6833e0b9b024741eb0616a5f62d5599/



DISCO_F746NG - Improvements

Who changed what in which revision?

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