Iftikhar Aziz / mbed-dev

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependents:   LSS_Rev_1

Fork of mbed-dev by Umar Naeem

targets/cmsis/TARGET_STM/TARGET_STM32F7/stm32f7xx_hal_smartcard.c@144:ef7eb2e8f9f7, 2016-09-02 (annotated)

Committer:
<>
Date:
Fri Sep 02 15:07:44 2016 +0100
Revision:
144:ef7eb2e8f9f7
Parent:
83:a036322b8637 
This updates the lib to the mbed lib v125

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 144:ef7eb2e8f9f7 1 /**
<> 144:ef7eb2e8f9f7 2 ******************************************************************************
<> 144:ef7eb2e8f9f7 3 * @file stm32f7xx_hal_smartcard.c
<> 144:ef7eb2e8f9f7 4 * @author MCD Application Team
<> 144:ef7eb2e8f9f7 5 * @version V1.1.0
<> 144:ef7eb2e8f9f7 6 * @date 22-April-2016
<> 144:ef7eb2e8f9f7 7 * @brief SMARTCARD HAL module driver.
<> 144:ef7eb2e8f9f7 8 * This file provides firmware functions to manage the following
<> 144:ef7eb2e8f9f7 9 * functionalities of the SMARTCARD peripheral:
<> 144:ef7eb2e8f9f7 10 * + Initialization and de-initialization functions
<> 144:ef7eb2e8f9f7 11 * + IO operation functions
<> 144:ef7eb2e8f9f7 12 * + Peripheral State and Errors functions
<> 144:ef7eb2e8f9f7 13 *
<> 144:ef7eb2e8f9f7 14 @verbatim
<> 144:ef7eb2e8f9f7 15 ==============================================================================
<> 144:ef7eb2e8f9f7 16 ##### How to use this driver #####
<> 144:ef7eb2e8f9f7 17 ==============================================================================
<> 144:ef7eb2e8f9f7 18 [..]
<> 144:ef7eb2e8f9f7 19 The SMARTCARD HAL driver can be used as follow:
<> 144:ef7eb2e8f9f7 20
<> 144:ef7eb2e8f9f7 21 (#) Declare a SMARTCARD_HandleTypeDef handle structure.
<> 144:ef7eb2e8f9f7 22 (#) Associate a USART to the SMARTCARD handle hsc.
<> 144:ef7eb2e8f9f7 23 (#) Initialize the SMARTCARD low level resources by implementing the HAL_SMARTCARD_MspInit() API:
<> 144:ef7eb2e8f9f7 24 (##) Enable the USARTx interface clock.
<> 144:ef7eb2e8f9f7 25 (##) SMARTCARD pins configuration:
<> 144:ef7eb2e8f9f7 26 (+++) Enable the clock for the SMARTCARD GPIOs.
<> 144:ef7eb2e8f9f7 27 (+++) Configure these SMARTCARD pins as alternate function pull-up.
<> 144:ef7eb2e8f9f7 28 (##) NVIC configuration if you need to use interrupt process (HAL_SMARTCARD_Transmit_IT()
<> 144:ef7eb2e8f9f7 29 and HAL_SMARTCARD_Receive_IT() APIs):
<> 144:ef7eb2e8f9f7 30 (+++) Configure the USARTx interrupt priority.
<> 144:ef7eb2e8f9f7 31 (+++) Enable the NVIC USART IRQ handle.
<> 144:ef7eb2e8f9f7 32 (+++) The specific USART interrupts (Transmission complete interrupt,
<> 144:ef7eb2e8f9f7 33 RXNE interrupt and Error Interrupts) will be managed using the macros
<> 144:ef7eb2e8f9f7 34 __HAL_SMARTCARD_ENABLE_IT() and __HAL_SMARTCARD_DISABLE_IT() inside the transmit and receive process.
<> 144:ef7eb2e8f9f7 35 (##) DMA Configuration if you need to use DMA process (HAL_SMARTCARD_Transmit_DMA()
<> 144:ef7eb2e8f9f7 36 and HAL_SMARTCARD_Receive_DMA() APIs):
<> 144:ef7eb2e8f9f7 37 (+++) Declare a DMA handle structure for the Tx/Rx stream.
<> 144:ef7eb2e8f9f7 38 (+++) Enable the DMAx interface clock.
<> 144:ef7eb2e8f9f7 39 (+++) Configure the declared DMA handle structure with the required Tx/Rx parameters.
<> 144:ef7eb2e8f9f7 40 (+++) Configure the DMA Tx/Rx Stream.
<> 144:ef7eb2e8f9f7 41 (+++) Associate the initialized DMA handle to the SMARTCARD DMA Tx/Rx handle.
<> 144:ef7eb2e8f9f7 42 (+++) Configure the priority and enable the NVIC for the transfer complete interrupt on the DMA Tx/Rx Stream.
<> 144:ef7eb2e8f9f7 43
<> 144:ef7eb2e8f9f7 44 (#) Program the Baud Rate, Parity, Mode(Receiver/Transmitter), clock enabling/disabling and accordingly,
<> 144:ef7eb2e8f9f7 45 the clock parameters (parity, phase, last bit), prescaler value, guard time and NACK on transmission
<> 144:ef7eb2e8f9f7 46 error enabling or disabling in the hsc Init structure.
<> 144:ef7eb2e8f9f7 47
<> 144:ef7eb2e8f9f7 48 (#) If required, program SMARTCARD advanced features (TX/RX pins swap, TimeOut, auto-retry counter,...)
<> 144:ef7eb2e8f9f7 49 in the hsc AdvancedInit structure.
<> 144:ef7eb2e8f9f7 50
<> 144:ef7eb2e8f9f7 51 (#) Initialize the SMARTCARD associated USART registers by calling
<> 144:ef7eb2e8f9f7 52 the HAL_SMARTCARD_Init() API.
<> 144:ef7eb2e8f9f7 53
<> 144:ef7eb2e8f9f7 54 [..]
<> 144:ef7eb2e8f9f7 55 (@) HAL_SMARTCARD_Init() API also configure also the low level Hardware GPIO, CLOCK, CORTEX...etc) by
<> 144:ef7eb2e8f9f7 56 calling the customized HAL_SMARTCARD_MspInit() API.
<> 144:ef7eb2e8f9f7 57
<> 144:ef7eb2e8f9f7 58 @endverbatim
<> 144:ef7eb2e8f9f7 59 ******************************************************************************
<> 144:ef7eb2e8f9f7 60 * @attention
<> 144:ef7eb2e8f9f7 61 *
<> 144:ef7eb2e8f9f7 62 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
<> 144:ef7eb2e8f9f7 63 *
<> 144:ef7eb2e8f9f7 64 * Redistribution and use in source and binary forms, with or without modification,
<> 144:ef7eb2e8f9f7 65 * are permitted provided that the following conditions are met:
<> 144:ef7eb2e8f9f7 66 * 1. Redistributions of source code must retain the above copyright notice,
<> 144:ef7eb2e8f9f7 67 * this list of conditions and the following disclaimer.
<> 144:ef7eb2e8f9f7 68 * 2. Redistributions in binary form must reproduce the above copyright notice,
<> 144:ef7eb2e8f9f7 69 * this list of conditions and the following disclaimer in the documentation
<> 144:ef7eb2e8f9f7 70 * and/or other materials provided with the distribution.
<> 144:ef7eb2e8f9f7 71 * 3. Neither the name of STMicroelectronics nor the names of its contributors
<> 144:ef7eb2e8f9f7 72 * may be used to endorse or promote products derived from this software
<> 144:ef7eb2e8f9f7 73 * without specific prior written permission.
<> 144:ef7eb2e8f9f7 74 *
<> 144:ef7eb2e8f9f7 75 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
<> 144:ef7eb2e8f9f7 76 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
<> 144:ef7eb2e8f9f7 77 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
<> 144:ef7eb2e8f9f7 78 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
<> 144:ef7eb2e8f9f7 79 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
<> 144:ef7eb2e8f9f7 80 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
<> 144:ef7eb2e8f9f7 81 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
<> 144:ef7eb2e8f9f7 82 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
<> 144:ef7eb2e8f9f7 83 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
<> 144:ef7eb2e8f9f7 84 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<> 144:ef7eb2e8f9f7 85 *
<> 144:ef7eb2e8f9f7 86 ******************************************************************************
<> 144:ef7eb2e8f9f7 87 */
<> 144:ef7eb2e8f9f7 88
<> 144:ef7eb2e8f9f7 89 /* Includes ------------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 90 #include "stm32f7xx_hal.h"
<> 144:ef7eb2e8f9f7 91
<> 144:ef7eb2e8f9f7 92 /** @addtogroup STM32F7xx_HAL_Driver
<> 144:ef7eb2e8f9f7 93 * @{
<> 144:ef7eb2e8f9f7 94 */
<> 144:ef7eb2e8f9f7 95
<> 144:ef7eb2e8f9f7 96 /** @defgroup SMARTCARD SMARTCARD
<> 144:ef7eb2e8f9f7 97 * @brief HAL USART SMARTCARD module driver
<> 144:ef7eb2e8f9f7 98 * @{
<> 144:ef7eb2e8f9f7 99 */
<> 144:ef7eb2e8f9f7 100 #ifdef HAL_SMARTCARD_MODULE_ENABLED
<> 144:ef7eb2e8f9f7 101 /* Private typedef -----------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 102 /* Private define ------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 103 /** @defgroup SMARTCARD_Private_Constants SMARTCARD Private Constants
<> 144:ef7eb2e8f9f7 104 * @{
<> 144:ef7eb2e8f9f7 105 */
<> 144:ef7eb2e8f9f7 106 #define TEACK_REACK_TIMEOUT 1000U
<> 144:ef7eb2e8f9f7 107 #define HAL_SMARTCARD_TXDMA_TIMEOUTVALUE 22000U
<> 144:ef7eb2e8f9f7 108 #define USART_CR1_FIELDS ((uint32_t)(USART_CR1_M | USART_CR1_PCE | USART_CR1_PS | \
<> 144:ef7eb2e8f9f7 109 USART_CR1_TE | USART_CR1_RE | USART_CR1_OVER8))
<> 144:ef7eb2e8f9f7 110 #define USART_CR2_CLK_FIELDS ((uint32_t)(USART_CR2_CLKEN|USART_CR2_CPOL|USART_CR2_CPHA|USART_CR2_LBCL))
<> 144:ef7eb2e8f9f7 111 #define USART_CR2_FIELDS ((uint32_t)(USART_CR2_RTOEN|USART_CR2_CLK_FIELDS|USART_CR2_STOP))
<> 144:ef7eb2e8f9f7 112 #define USART_CR3_FIELDS ((uint32_t)(USART_CR3_ONEBIT|USART_CR3_NACK|USART_CR3_SCARCNT))
<> 144:ef7eb2e8f9f7 113 /**
<> 144:ef7eb2e8f9f7 114 * @}
<> 144:ef7eb2e8f9f7 115 */
<> 144:ef7eb2e8f9f7 116 /* Private macros -------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 117 /* Private variables ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 118 /* Private function prototypes -----------------------------------------------*/
<> 144:ef7eb2e8f9f7 119 /** @addtogroup SMARTCARD_Private_Functions
<> 144:ef7eb2e8f9f7 120 * @{
<> 144:ef7eb2e8f9f7 121 */
<> 144:ef7eb2e8f9f7 122 static void SMARTCARD_DMATransmitCplt(DMA_HandleTypeDef *hdma);
<> 144:ef7eb2e8f9f7 123 static void SMARTCARD_DMAReceiveCplt(DMA_HandleTypeDef *hdma);
<> 144:ef7eb2e8f9f7 124 static void SMARTCARD_DMAError(DMA_HandleTypeDef *hdma);
<> 144:ef7eb2e8f9f7 125 static void SMARTCARD_DMAAbortOnError(DMA_HandleTypeDef *hdma);
<> 144:ef7eb2e8f9f7 126 static void SMARTCARD_SetConfig(SMARTCARD_HandleTypeDef *hsc);
<> 144:ef7eb2e8f9f7 127 static HAL_StatusTypeDef SMARTCARD_WaitOnFlagUntilTimeout(SMARTCARD_HandleTypeDef *hsc, uint32_t Flag, FlagStatus Status, uint32_t Tickstart, uint32_t Timeout);
<> 144:ef7eb2e8f9f7 128 static HAL_StatusTypeDef SMARTCARD_CheckIdleState(SMARTCARD_HandleTypeDef *hsc);
<> 144:ef7eb2e8f9f7 129 static HAL_StatusTypeDef SMARTCARD_Transmit_IT(SMARTCARD_HandleTypeDef *hsc);
<> 144:ef7eb2e8f9f7 130 static HAL_StatusTypeDef SMARTCARD_Receive_IT(SMARTCARD_HandleTypeDef *hsc);
<> 144:ef7eb2e8f9f7 131 static void SMARTCARD_EndTxTransfer(SMARTCARD_HandleTypeDef *hsc);
<> 144:ef7eb2e8f9f7 132 static void SMARTCARD_EndRxTransfer(SMARTCARD_HandleTypeDef *hsc);
<> 144:ef7eb2e8f9f7 133 static void SMARTCARD_AdvFeatureConfig(SMARTCARD_HandleTypeDef *hsc);
<> 144:ef7eb2e8f9f7 134 /**
<> 144:ef7eb2e8f9f7 135 * @}
<> 144:ef7eb2e8f9f7 136 */
<> 144:ef7eb2e8f9f7 137 /* Exported functions --------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 138 /** @defgroup SMARTCARD_Exported_Functions SMARTCARD Exported Functions
<> 144:ef7eb2e8f9f7 139 * @{
<> 144:ef7eb2e8f9f7 140 */
<> 144:ef7eb2e8f9f7 141
<> 144:ef7eb2e8f9f7 142 /** @defgroup SMARTCARD_Exported_Functions_Group1 SmartCard Initialization and de-initialization functions
<> 144:ef7eb2e8f9f7 143 * @brief Initialization and Configuration functions
<> 144:ef7eb2e8f9f7 144 *
<> 144:ef7eb2e8f9f7 145 @verbatim
<> 144:ef7eb2e8f9f7 146 ===============================================================================
<> 144:ef7eb2e8f9f7 147 ##### Initialization and Configuration functions #####
<> 144:ef7eb2e8f9f7 148 ===============================================================================
<> 144:ef7eb2e8f9f7 149 [..]
<> 144:ef7eb2e8f9f7 150 This subsection provides a set of functions allowing to initialize the USART
<> 144:ef7eb2e8f9f7 151 associated to the SmartCard.
<> 144:ef7eb2e8f9f7 152 (+) These parameters can be configured:
<> 144:ef7eb2e8f9f7 153 (++) Baud Rate
<> 144:ef7eb2e8f9f7 154 (++) Parity: parity should be enabled,
<> 144:ef7eb2e8f9f7 155 Frame Length is fixed to 8 bits plus parity.
<> 144:ef7eb2e8f9f7 156 (++) Receiver/transmitter modes
<> 144:ef7eb2e8f9f7 157 (++) Synchronous mode (and if enabled, phase, polarity and last bit parameters)
<> 144:ef7eb2e8f9f7 158 (++) Prescaler value
<> 144:ef7eb2e8f9f7 159 (++) Guard bit time
<> 144:ef7eb2e8f9f7 160 (++) NACK enabling or disabling on transmission error
<> 144:ef7eb2e8f9f7 161
<> 144:ef7eb2e8f9f7 162 (+) The following advanced features can be configured as well:
<> 144:ef7eb2e8f9f7 163 (++) TX and/or RX pin level inversion
<> 144:ef7eb2e8f9f7 164 (++) data logical level inversion
<> 144:ef7eb2e8f9f7 165 (++) RX and TX pins swap
<> 144:ef7eb2e8f9f7 166 (++) RX overrun detection disabling
<> 144:ef7eb2e8f9f7 167 (++) DMA disabling on RX error
<> 144:ef7eb2e8f9f7 168 (++) MSB first on communication line
<> 144:ef7eb2e8f9f7 169 (++) Time out enabling (and if activated, timeout value)
<> 144:ef7eb2e8f9f7 170 (++) Block length
<> 144:ef7eb2e8f9f7 171 (++) Auto-retry counter
<> 144:ef7eb2e8f9f7 172
<> 144:ef7eb2e8f9f7 173 [..]
<> 144:ef7eb2e8f9f7 174 The HAL_SMARTCARD_Init() API follow respectively the USART (a)synchronous configuration procedures
<> 144:ef7eb2e8f9f7 175 (details for the procedures are available in reference manual).
<> 144:ef7eb2e8f9f7 176
<> 144:ef7eb2e8f9f7 177 @endverbatim
<> 144:ef7eb2e8f9f7 178
<> 144:ef7eb2e8f9f7 179 The USART frame format is given in the following table:
<> 144:ef7eb2e8f9f7 180
<> 144:ef7eb2e8f9f7 181 +---------------------------------------------------------------+
<> 144:ef7eb2e8f9f7 182 | M1M0 bits | PCE bit | USART frame |
<> 144:ef7eb2e8f9f7 183 |-----------------------|---------------------------------------|
<> 144:ef7eb2e8f9f7 184 | 01 | 1 | | SB | 8 bit data | PB | STB | |
<> 144:ef7eb2e8f9f7 185 +---------------------------------------------------------------+
<> 144:ef7eb2e8f9f7 186
<> 144:ef7eb2e8f9f7 187 * @{
<> 144:ef7eb2e8f9f7 188 */
<> 144:ef7eb2e8f9f7 189
<> 144:ef7eb2e8f9f7 190 /**
<> 144:ef7eb2e8f9f7 191 * @brief Initializes the SMARTCARD mode according to the specified
<> 144:ef7eb2e8f9f7 192 * parameters in the SMARTCARD_InitTypeDef and create the associated handle .
<> 144:ef7eb2e8f9f7 193 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 194 * @retval HAL status
<> 144:ef7eb2e8f9f7 195 */
<> 144:ef7eb2e8f9f7 196 HAL_StatusTypeDef HAL_SMARTCARD_Init(SMARTCARD_HandleTypeDef *hsc)
<> 144:ef7eb2e8f9f7 197 {
<> 144:ef7eb2e8f9f7 198 /* Check the SMARTCARD handle allocation */
<> 144:ef7eb2e8f9f7 199 if(hsc == NULL)
<> 144:ef7eb2e8f9f7 200 {
<> 144:ef7eb2e8f9f7 201 return HAL_ERROR;
<> 144:ef7eb2e8f9f7 202 }
<> 144:ef7eb2e8f9f7 203
<> 144:ef7eb2e8f9f7 204 /* Check the parameters */
<> 144:ef7eb2e8f9f7 205 assert_param(IS_SMARTCARD_INSTANCE(hsc->Instance));
<> 144:ef7eb2e8f9f7 206
<> 144:ef7eb2e8f9f7 207 if(hsc->gState == HAL_SMARTCARD_STATE_RESET)
<> 144:ef7eb2e8f9f7 208 {
<> 144:ef7eb2e8f9f7 209 /* Allocate lock resource and initialize it */
<> 144:ef7eb2e8f9f7 210 hsc->Lock = HAL_UNLOCKED;
<> 144:ef7eb2e8f9f7 211 /* Init the low level hardware : GPIO, CLOCK, CORTEX */
<> 144:ef7eb2e8f9f7 212 HAL_SMARTCARD_MspInit(hsc);
<> 144:ef7eb2e8f9f7 213 }
<> 144:ef7eb2e8f9f7 214
<> 144:ef7eb2e8f9f7 215 hsc->gState = HAL_SMARTCARD_STATE_BUSY;
<> 144:ef7eb2e8f9f7 216
<> 144:ef7eb2e8f9f7 217 /* Disable the Peripheral */
<> 144:ef7eb2e8f9f7 218 __HAL_SMARTCARD_DISABLE(hsc);
<> 144:ef7eb2e8f9f7 219
<> 144:ef7eb2e8f9f7 220 /* Set the SMARTCARD Communication parameters */
<> 144:ef7eb2e8f9f7 221 SMARTCARD_SetConfig(hsc);
<> 144:ef7eb2e8f9f7 222
<> 144:ef7eb2e8f9f7 223 if(hsc->AdvancedInit.AdvFeatureInit != SMARTCARD_ADVFEATURE_NO_INIT)
<> 144:ef7eb2e8f9f7 224 {
<> 144:ef7eb2e8f9f7 225 SMARTCARD_AdvFeatureConfig(hsc);
<> 144:ef7eb2e8f9f7 226 }
<> 144:ef7eb2e8f9f7 227
<> 144:ef7eb2e8f9f7 228 /* In SmartCard mode, the following bits must be kept cleared:
<> 144:ef7eb2e8f9f7 229 - LINEN in the USART_CR2 register,
<> 144:ef7eb2e8f9f7 230 - HDSEL and IREN bits in the USART_CR3 register.*/
<> 144:ef7eb2e8f9f7 231 CLEAR_BIT(hsc->Instance->CR2, USART_CR2_LINEN);
<> 144:ef7eb2e8f9f7 232 CLEAR_BIT(hsc->Instance->CR3, (USART_CR3_IREN | USART_CR3_HDSEL));
<> 144:ef7eb2e8f9f7 233
<> 144:ef7eb2e8f9f7 234 /* set the USART in SMARTCARD mode */
<> 144:ef7eb2e8f9f7 235 SET_BIT(hsc->Instance->CR3, USART_CR3_SCEN);
<> 144:ef7eb2e8f9f7 236
<> 144:ef7eb2e8f9f7 237 /* Enable the Peripheral */
<> 144:ef7eb2e8f9f7 238 __HAL_SMARTCARD_ENABLE(hsc);
<> 144:ef7eb2e8f9f7 239
<> 144:ef7eb2e8f9f7 240 /* TEACK and/or REACK to check before moving hsc->State to Ready */
<> 144:ef7eb2e8f9f7 241 return (SMARTCARD_CheckIdleState(hsc));
<> 144:ef7eb2e8f9f7 242 }
<> 144:ef7eb2e8f9f7 243
<> 144:ef7eb2e8f9f7 244 /**
<> 144:ef7eb2e8f9f7 245 * @brief DeInitializes the SMARTCARD peripheral
<> 144:ef7eb2e8f9f7 246 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 247 * @retval HAL status
<> 144:ef7eb2e8f9f7 248 */
<> 144:ef7eb2e8f9f7 249 HAL_StatusTypeDef HAL_SMARTCARD_DeInit(SMARTCARD_HandleTypeDef *hsc)
<> 144:ef7eb2e8f9f7 250 {
<> 144:ef7eb2e8f9f7 251 /* Check the SMARTCARD handle allocation */
<> 144:ef7eb2e8f9f7 252 if(hsc == NULL)
<> 144:ef7eb2e8f9f7 253 {
<> 144:ef7eb2e8f9f7 254 return HAL_ERROR;
<> 144:ef7eb2e8f9f7 255 }
<> 144:ef7eb2e8f9f7 256
<> 144:ef7eb2e8f9f7 257 /* Check the parameters */
<> 144:ef7eb2e8f9f7 258 assert_param(IS_SMARTCARD_INSTANCE(hsc->Instance));
<> 144:ef7eb2e8f9f7 259
<> 144:ef7eb2e8f9f7 260 hsc->gState = HAL_SMARTCARD_STATE_BUSY;
<> 144:ef7eb2e8f9f7 261
<> 144:ef7eb2e8f9f7 262 /* DeInit the low level hardware */
<> 144:ef7eb2e8f9f7 263 HAL_SMARTCARD_MspDeInit(hsc);
<> 144:ef7eb2e8f9f7 264
<> 144:ef7eb2e8f9f7 265 hsc->ErrorCode = HAL_SMARTCARD_ERROR_NONE;
<> 144:ef7eb2e8f9f7 266 hsc->gState = HAL_SMARTCARD_STATE_RESET;
<> 144:ef7eb2e8f9f7 267 hsc->RxState = HAL_SMARTCARD_STATE_RESET;
<> 144:ef7eb2e8f9f7 268
<> 144:ef7eb2e8f9f7 269 /* Release Lock */
<> 144:ef7eb2e8f9f7 270 __HAL_UNLOCK(hsc);
<> 144:ef7eb2e8f9f7 271
<> 144:ef7eb2e8f9f7 272 return HAL_OK;
<> 144:ef7eb2e8f9f7 273 }
<> 144:ef7eb2e8f9f7 274
<> 144:ef7eb2e8f9f7 275 /**
<> 144:ef7eb2e8f9f7 276 * @brief SMARTCARD MSP Init
<> 144:ef7eb2e8f9f7 277 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 278 * @retval None
<> 144:ef7eb2e8f9f7 279 */
<> 144:ef7eb2e8f9f7 280 __weak void HAL_SMARTCARD_MspInit(SMARTCARD_HandleTypeDef *hsc)
<> 144:ef7eb2e8f9f7 281 {
<> 144:ef7eb2e8f9f7 282 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 283 UNUSED(hsc);
<> 144:ef7eb2e8f9f7 284
<> 144:ef7eb2e8f9f7 285 /* NOTE : This function Should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 286 the HAL_SMARTCARD_MspInit could be implemented in the user file
<> 144:ef7eb2e8f9f7 287 */
<> 144:ef7eb2e8f9f7 288 }
<> 144:ef7eb2e8f9f7 289
<> 144:ef7eb2e8f9f7 290 /**
<> 144:ef7eb2e8f9f7 291 * @brief SMARTCARD MSP DeInit
<> 144:ef7eb2e8f9f7 292 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 293 * @retval None
<> 144:ef7eb2e8f9f7 294 */
<> 144:ef7eb2e8f9f7 295 __weak void HAL_SMARTCARD_MspDeInit(SMARTCARD_HandleTypeDef *hsc)
<> 144:ef7eb2e8f9f7 296 {
<> 144:ef7eb2e8f9f7 297 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 298 UNUSED(hsc);
<> 144:ef7eb2e8f9f7 299
<> 144:ef7eb2e8f9f7 300 /* NOTE : This function Should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 301 the HAL_SMARTCARD_MspDeInit could be implemented in the user file
<> 144:ef7eb2e8f9f7 302 */
<> 144:ef7eb2e8f9f7 303 }
<> 144:ef7eb2e8f9f7 304
<> 144:ef7eb2e8f9f7 305 /**
<> 144:ef7eb2e8f9f7 306 * @}
<> 144:ef7eb2e8f9f7 307 */
<> 144:ef7eb2e8f9f7 308
<> 144:ef7eb2e8f9f7 309 /** @defgroup SMARTCARD_Exported_Functions_Group2 IO operation functions
<> 144:ef7eb2e8f9f7 310 * @brief SMARTCARD Transmit and Receive functions
<> 144:ef7eb2e8f9f7 311 *
<> 144:ef7eb2e8f9f7 312 @verbatim
<> 144:ef7eb2e8f9f7 313 ===============================================================================
<> 144:ef7eb2e8f9f7 314 ##### IO operation functions #####
<> 144:ef7eb2e8f9f7 315 ===============================================================================
<> 144:ef7eb2e8f9f7 316 This subsection provides a set of functions allowing to manage the SMARTCARD data transfers.
<> 144:ef7eb2e8f9f7 317
<> 144:ef7eb2e8f9f7 318 (#) There are two modes of transfer:
<> 144:ef7eb2e8f9f7 319 (+) Blocking mode: The communication is performed in polling mode.
<> 144:ef7eb2e8f9f7 320 The HAL status of all data processing is returned by the same function
<> 144:ef7eb2e8f9f7 321 after finishing transfer.
<> 144:ef7eb2e8f9f7 322 (+) No-Blocking mode: The communication is performed using Interrupts
<> 144:ef7eb2e8f9f7 323 or DMA, These API's return the HAL status.
<> 144:ef7eb2e8f9f7 324 The end of the data processing will be indicated through the
<> 144:ef7eb2e8f9f7 325 dedicated SMARTCARD IRQ when using Interrupt mode or the DMA IRQ when
<> 144:ef7eb2e8f9f7 326 using DMA mode.
<> 144:ef7eb2e8f9f7 327 The HAL_SMARTCARD_TxCpltCallback(), HAL_SMARTCARD_RxCpltCallback() user callbacks
<> 144:ef7eb2e8f9f7 328 will be executed respectively at the end of the Transmit or Receive process
<> 144:ef7eb2e8f9f7 329 The HAL_SMARTCARD_ErrorCallback()user callback will be executed when a communication error is detected
<> 144:ef7eb2e8f9f7 330
<> 144:ef7eb2e8f9f7 331 (#) Blocking mode API's are :
<> 144:ef7eb2e8f9f7 332 (+) HAL_SMARTCARD_Transmit()
<> 144:ef7eb2e8f9f7 333 (+) HAL_SMARTCARD_Receive()
<> 144:ef7eb2e8f9f7 334
<> 144:ef7eb2e8f9f7 335 (#) Non-Blocking mode API's with Interrupt are :
<> 144:ef7eb2e8f9f7 336 (+) HAL_SMARTCARD_Transmit_IT()
<> 144:ef7eb2e8f9f7 337 (+) HAL_SMARTCARD_Receive_IT()
<> 144:ef7eb2e8f9f7 338 (+) HAL_SMARTCARD_IRQHandler()
<> 144:ef7eb2e8f9f7 339 (+) SMARTCARD_Transmit_IT()
<> 144:ef7eb2e8f9f7 340 (+) SMARTCARD_Receive_IT()
<> 144:ef7eb2e8f9f7 341
<> 144:ef7eb2e8f9f7 342 (#) No-Blocking mode functions with DMA are :
<> 144:ef7eb2e8f9f7 343 (+) HAL_SMARTCARD_Transmit_DMA()
<> 144:ef7eb2e8f9f7 344 (+) HAL_SMARTCARD_Receive_DMA()
<> 144:ef7eb2e8f9f7 345
<> 144:ef7eb2e8f9f7 346 (#) A set of Transfer Complete Callbacks are provided in No_Blocking mode:
<> 144:ef7eb2e8f9f7 347 (+) HAL_SMARTCARD_TxCpltCallback()
<> 144:ef7eb2e8f9f7 348 (+) HAL_SMARTCARD_RxCpltCallback()
<> 144:ef7eb2e8f9f7 349 (+) HAL_SMARTCARD_ErrorCallback()
<> 144:ef7eb2e8f9f7 350
<> 144:ef7eb2e8f9f7 351 @endverbatim
<> 144:ef7eb2e8f9f7 352 * @{
<> 144:ef7eb2e8f9f7 353 */
<> 144:ef7eb2e8f9f7 354
<> 144:ef7eb2e8f9f7 355 /**
<> 144:ef7eb2e8f9f7 356 * @brief Send an amount of data in blocking mode
<> 144:ef7eb2e8f9f7 357 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 358 * @param pData: pointer to data buffer
<> 144:ef7eb2e8f9f7 359 * @param Size: amount of data to be sent
<> 144:ef7eb2e8f9f7 360 * @param Timeout: Timeout duration
<> 144:ef7eb2e8f9f7 361 * @retval HAL status
<> 144:ef7eb2e8f9f7 362 */
<> 144:ef7eb2e8f9f7 363 HAL_StatusTypeDef HAL_SMARTCARD_Transmit(SMARTCARD_HandleTypeDef *hsc, uint8_t *pData, uint16_t Size, uint32_t Timeout)
<> 144:ef7eb2e8f9f7 364 {
<> 144:ef7eb2e8f9f7 365 uint32_t tickstart = 0U;
<> 144:ef7eb2e8f9f7 366
<> 144:ef7eb2e8f9f7 367 if(hsc->gState == HAL_SMARTCARD_STATE_READY)
<> 144:ef7eb2e8f9f7 368 {
<> 144:ef7eb2e8f9f7 369 if((pData == NULL) || (Size == 0U))
<> 144:ef7eb2e8f9f7 370 {
<> 144:ef7eb2e8f9f7 371 return HAL_ERROR;
<> 144:ef7eb2e8f9f7 372 }
<> 144:ef7eb2e8f9f7 373
<> 144:ef7eb2e8f9f7 374 /* Process Locked */
<> 144:ef7eb2e8f9f7 375 __HAL_LOCK(hsc);
<> 144:ef7eb2e8f9f7 376 hsc->ErrorCode = HAL_SMARTCARD_ERROR_NONE;
<> 144:ef7eb2e8f9f7 377 hsc->gState = HAL_SMARTCARD_STATE_BUSY_TX;
<> 144:ef7eb2e8f9f7 378
<> 144:ef7eb2e8f9f7 379 /* Init tickstart for timeout managment*/
<> 144:ef7eb2e8f9f7 380 tickstart = HAL_GetTick();
<> 144:ef7eb2e8f9f7 381
<> 144:ef7eb2e8f9f7 382 hsc->TxXferSize = Size;
<> 144:ef7eb2e8f9f7 383 hsc->TxXferCount = Size;
<> 144:ef7eb2e8f9f7 384 while(hsc->TxXferCount > 0U)
<> 144:ef7eb2e8f9f7 385 {
<> 144:ef7eb2e8f9f7 386 hsc->TxXferCount--;
<> 144:ef7eb2e8f9f7 387 if(SMARTCARD_WaitOnFlagUntilTimeout(hsc, SMARTCARD_FLAG_TXE, RESET, tickstart, Timeout) != HAL_OK)
<> 144:ef7eb2e8f9f7 388 {
<> 144:ef7eb2e8f9f7 389 return HAL_TIMEOUT;
<> 144:ef7eb2e8f9f7 390 }
<> 144:ef7eb2e8f9f7 391 hsc->Instance->TDR = (*pData++ & (uint8_t)0xFFU);
<> 144:ef7eb2e8f9f7 392 }
<> 144:ef7eb2e8f9f7 393 if(SMARTCARD_WaitOnFlagUntilTimeout(hsc, SMARTCARD_FLAG_TC, RESET, tickstart, Timeout) != HAL_OK)
<> 144:ef7eb2e8f9f7 394 {
<> 144:ef7eb2e8f9f7 395 return HAL_TIMEOUT;
<> 144:ef7eb2e8f9f7 396 }
<> 144:ef7eb2e8f9f7 397
<> 144:ef7eb2e8f9f7 398 /* At end of Tx process, restore hsc->gState to Ready */
<> 144:ef7eb2e8f9f7 399 hsc->gState = HAL_SMARTCARD_STATE_READY;
<> 144:ef7eb2e8f9f7 400
<> 144:ef7eb2e8f9f7 401 /* Process Unlocked */
<> 144:ef7eb2e8f9f7 402 __HAL_UNLOCK(hsc);
<> 144:ef7eb2e8f9f7 403
<> 144:ef7eb2e8f9f7 404 return HAL_OK;
<> 144:ef7eb2e8f9f7 405 }
<> 144:ef7eb2e8f9f7 406 else
<> 144:ef7eb2e8f9f7 407 {
<> 144:ef7eb2e8f9f7 408 return HAL_BUSY;
<> 144:ef7eb2e8f9f7 409 }
<> 144:ef7eb2e8f9f7 410 }
<> 144:ef7eb2e8f9f7 411
<> 144:ef7eb2e8f9f7 412 /**
<> 144:ef7eb2e8f9f7 413 * @brief Receive an amount of data in blocking mode
<> 144:ef7eb2e8f9f7 414 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 415 * @param pData: pointer to data buffer
<> 144:ef7eb2e8f9f7 416 * @param Size: amount of data to be received
<> 144:ef7eb2e8f9f7 417 * @param Timeout: Timeout duration
<> 144:ef7eb2e8f9f7 418 * @retval HAL status
<> 144:ef7eb2e8f9f7 419 */
<> 144:ef7eb2e8f9f7 420 HAL_StatusTypeDef HAL_SMARTCARD_Receive(SMARTCARD_HandleTypeDef *hsc, uint8_t *pData, uint16_t Size, uint32_t Timeout)
<> 144:ef7eb2e8f9f7 421 {
<> 144:ef7eb2e8f9f7 422 uint32_t tickstart = 0U;
<> 144:ef7eb2e8f9f7 423
<> 144:ef7eb2e8f9f7 424 if(hsc->RxState == HAL_SMARTCARD_STATE_READY)
<> 144:ef7eb2e8f9f7 425 {
<> 144:ef7eb2e8f9f7 426 if((pData == NULL) || (Size == 0U))
<> 144:ef7eb2e8f9f7 427 {
<> 144:ef7eb2e8f9f7 428 return HAL_ERROR;
<> 144:ef7eb2e8f9f7 429 }
<> 144:ef7eb2e8f9f7 430
<> 144:ef7eb2e8f9f7 431 /* Process Locked */
<> 144:ef7eb2e8f9f7 432 __HAL_LOCK(hsc);
<> 144:ef7eb2e8f9f7 433
<> 144:ef7eb2e8f9f7 434 hsc->ErrorCode = HAL_SMARTCARD_ERROR_NONE;
<> 144:ef7eb2e8f9f7 435 hsc->RxState = HAL_SMARTCARD_STATE_BUSY_RX;
<> 144:ef7eb2e8f9f7 436
<> 144:ef7eb2e8f9f7 437 /* Init tickstart for timeout managment*/
<> 144:ef7eb2e8f9f7 438 tickstart = HAL_GetTick();
<> 144:ef7eb2e8f9f7 439
<> 144:ef7eb2e8f9f7 440 hsc->RxXferSize = Size;
<> 144:ef7eb2e8f9f7 441 hsc->RxXferCount = Size;
<> 144:ef7eb2e8f9f7 442 /* Check the remain data to be received */
<> 144:ef7eb2e8f9f7 443 while(hsc->RxXferCount > 0U)
<> 144:ef7eb2e8f9f7 444 {
<> 144:ef7eb2e8f9f7 445 hsc->RxXferCount--;
<> 144:ef7eb2e8f9f7 446 if(SMARTCARD_WaitOnFlagUntilTimeout(hsc, SMARTCARD_FLAG_RXNE, RESET, tickstart, Timeout) != HAL_OK)
<> 144:ef7eb2e8f9f7 447 {
<> 144:ef7eb2e8f9f7 448 return HAL_TIMEOUT;
<> 144:ef7eb2e8f9f7 449 }
<> 144:ef7eb2e8f9f7 450 *pData++ = (uint8_t)(hsc->Instance->RDR & (uint8_t)0x00FFU);
<> 144:ef7eb2e8f9f7 451 }
<> 144:ef7eb2e8f9f7 452
<> 144:ef7eb2e8f9f7 453 /* At end of Rx process, restore hsc->RxState to Ready */
<> 144:ef7eb2e8f9f7 454 hsc->RxState = HAL_SMARTCARD_STATE_READY;
<> 144:ef7eb2e8f9f7 455
<> 144:ef7eb2e8f9f7 456 /* Process Unlocked */
<> 144:ef7eb2e8f9f7 457 __HAL_UNLOCK(hsc);
<> 144:ef7eb2e8f9f7 458
<> 144:ef7eb2e8f9f7 459 return HAL_OK;
<> 144:ef7eb2e8f9f7 460 }
<> 144:ef7eb2e8f9f7 461 else
<> 144:ef7eb2e8f9f7 462 {
<> 144:ef7eb2e8f9f7 463 return HAL_BUSY;
<> 144:ef7eb2e8f9f7 464 }
<> 144:ef7eb2e8f9f7 465 }
<> 144:ef7eb2e8f9f7 466
<> 144:ef7eb2e8f9f7 467 /**
<> 144:ef7eb2e8f9f7 468 * @brief Send an amount of data in interrupt mode
<> 144:ef7eb2e8f9f7 469 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 470 * @param pData: pointer to data buffer
<> 144:ef7eb2e8f9f7 471 * @param Size: amount of data to be sent
<> 144:ef7eb2e8f9f7 472 * @retval HAL status
<> 144:ef7eb2e8f9f7 473 */
<> 144:ef7eb2e8f9f7 474 HAL_StatusTypeDef HAL_SMARTCARD_Transmit_IT(SMARTCARD_HandleTypeDef *hsc, uint8_t *pData, uint16_t Size)
<> 144:ef7eb2e8f9f7 475 {
<> 144:ef7eb2e8f9f7 476 /* Check that a Tx process is not already ongoing */
<> 144:ef7eb2e8f9f7 477 if(hsc->gState == HAL_SMARTCARD_STATE_READY)
<> 144:ef7eb2e8f9f7 478 {
<> 144:ef7eb2e8f9f7 479 if((pData == NULL) || (Size == 0U))
<> 144:ef7eb2e8f9f7 480 {
<> 144:ef7eb2e8f9f7 481 return HAL_ERROR;
<> 144:ef7eb2e8f9f7 482 }
<> 144:ef7eb2e8f9f7 483
<> 144:ef7eb2e8f9f7 484 /* Process Locked */
<> 144:ef7eb2e8f9f7 485 __HAL_LOCK(hsc);
<> 144:ef7eb2e8f9f7 486
<> 144:ef7eb2e8f9f7 487 hsc->pTxBuffPtr = pData;
<> 144:ef7eb2e8f9f7 488 hsc->TxXferSize = Size;
<> 144:ef7eb2e8f9f7 489 hsc->TxXferCount = Size;
<> 144:ef7eb2e8f9f7 490
<> 144:ef7eb2e8f9f7 491 hsc->ErrorCode = HAL_SMARTCARD_ERROR_NONE;
<> 144:ef7eb2e8f9f7 492 hsc->gState = HAL_SMARTCARD_STATE_BUSY_TX;
<> 144:ef7eb2e8f9f7 493
<> 144:ef7eb2e8f9f7 494 /* Process Unlocked */
<> 144:ef7eb2e8f9f7 495 __HAL_UNLOCK(hsc);
<> 144:ef7eb2e8f9f7 496
<> 144:ef7eb2e8f9f7 497 /* Enable the SMARTCARD Error Interrupt: (Frame error, noise error, overrun error) */
<> 144:ef7eb2e8f9f7 498 CLEAR_BIT(hsc->Instance->CR3, USART_CR3_EIE);
<> 144:ef7eb2e8f9f7 499
<> 144:ef7eb2e8f9f7 500 /* Enable the SMARTCARD Transmit Complete Interrupt */
<> 144:ef7eb2e8f9f7 501 CLEAR_BIT(hsc->Instance->CR1, USART_CR1_TCIE);
<> 144:ef7eb2e8f9f7 502
<> 144:ef7eb2e8f9f7 503 return HAL_OK;
<> 144:ef7eb2e8f9f7 504 }
<> 144:ef7eb2e8f9f7 505 else
<> 144:ef7eb2e8f9f7 506 {
<> 144:ef7eb2e8f9f7 507 return HAL_BUSY;
<> 144:ef7eb2e8f9f7 508 }
<> 144:ef7eb2e8f9f7 509 }
<> 144:ef7eb2e8f9f7 510
<> 144:ef7eb2e8f9f7 511 /**
<> 144:ef7eb2e8f9f7 512 * @brief Receive an amount of data in interrupt mode
<> 144:ef7eb2e8f9f7 513 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 514 * @param pData: pointer to data buffer
<> 144:ef7eb2e8f9f7 515 * @param Size: amount of data to be received
<> 144:ef7eb2e8f9f7 516 * @retval HAL status
<> 144:ef7eb2e8f9f7 517 */
<> 144:ef7eb2e8f9f7 518 HAL_StatusTypeDef HAL_SMARTCARD_Receive_IT(SMARTCARD_HandleTypeDef *hsc, uint8_t *pData, uint16_t Size)
<> 144:ef7eb2e8f9f7 519 {
<> 144:ef7eb2e8f9f7 520 /* Check that a Rx process is not already ongoing */
<> 144:ef7eb2e8f9f7 521 if(hsc->RxState == HAL_SMARTCARD_STATE_READY)
<> 144:ef7eb2e8f9f7 522 {
<> 144:ef7eb2e8f9f7 523 if((pData == NULL) || (Size == 0U))
<> 144:ef7eb2e8f9f7 524 {
<> 144:ef7eb2e8f9f7 525 return HAL_ERROR;
<> 144:ef7eb2e8f9f7 526 }
<> 144:ef7eb2e8f9f7 527
<> 144:ef7eb2e8f9f7 528 /* Process Locked */
<> 144:ef7eb2e8f9f7 529 __HAL_LOCK(hsc);
<> 144:ef7eb2e8f9f7 530
<> 144:ef7eb2e8f9f7 531 hsc->pRxBuffPtr = pData;
<> 144:ef7eb2e8f9f7 532 hsc->RxXferSize = Size;
<> 144:ef7eb2e8f9f7 533 hsc->RxXferCount = Size;
<> 144:ef7eb2e8f9f7 534
<> 144:ef7eb2e8f9f7 535 hsc->ErrorCode = HAL_SMARTCARD_ERROR_NONE;
<> 144:ef7eb2e8f9f7 536 hsc->RxState = HAL_SMARTCARD_STATE_BUSY_RX;
<> 144:ef7eb2e8f9f7 537
<> 144:ef7eb2e8f9f7 538 /* Process Unlocked */
<> 144:ef7eb2e8f9f7 539 __HAL_UNLOCK(hsc);
<> 144:ef7eb2e8f9f7 540
<> 144:ef7eb2e8f9f7 541 /* Enable the SMARTCARD Parity Error Interrupt */
<> 144:ef7eb2e8f9f7 542 SET_BIT(hsc->Instance->CR1, USART_CR1_PEIE);
<> 144:ef7eb2e8f9f7 543
<> 144:ef7eb2e8f9f7 544 /* Enable the SMARTCARD Error Interrupt: (Frame error, noise error, overrun error) */
<> 144:ef7eb2e8f9f7 545 SET_BIT(hsc->Instance->CR3, USART_CR3_EIE);
<> 144:ef7eb2e8f9f7 546
<> 144:ef7eb2e8f9f7 547 /* Enable the SMARTCARD Data Register not empty Interrupt */
<> 144:ef7eb2e8f9f7 548 SET_BIT(hsc->Instance->CR1, USART_CR1_RXNEIE);
<> 144:ef7eb2e8f9f7 549
<> 144:ef7eb2e8f9f7 550 return HAL_OK;
<> 144:ef7eb2e8f9f7 551 }
<> 144:ef7eb2e8f9f7 552 else
<> 144:ef7eb2e8f9f7 553 {
<> 144:ef7eb2e8f9f7 554 return HAL_BUSY;
<> 144:ef7eb2e8f9f7 555 }
<> 144:ef7eb2e8f9f7 556 }
<> 144:ef7eb2e8f9f7 557
<> 144:ef7eb2e8f9f7 558 /**
<> 144:ef7eb2e8f9f7 559 * @brief Send an amount of data in DMA mode
<> 144:ef7eb2e8f9f7 560 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 561 * @param pData: pointer to data buffer
<> 144:ef7eb2e8f9f7 562 * @param Size: amount of data to be sent
<> 144:ef7eb2e8f9f7 563 * @retval HAL status
<> 144:ef7eb2e8f9f7 564 */
<> 144:ef7eb2e8f9f7 565 HAL_StatusTypeDef HAL_SMARTCARD_Transmit_DMA(SMARTCARD_HandleTypeDef *hsc, uint8_t *pData, uint16_t Size)
<> 144:ef7eb2e8f9f7 566 {
<> 144:ef7eb2e8f9f7 567 uint32_t *tmp;
<> 144:ef7eb2e8f9f7 568
<> 144:ef7eb2e8f9f7 569 /* Check that a Tx process is not already ongoing */
<> 144:ef7eb2e8f9f7 570 if(hsc->gState == HAL_SMARTCARD_STATE_READY)
<> 144:ef7eb2e8f9f7 571 {
<> 144:ef7eb2e8f9f7 572 if((pData == NULL) || (Size == 0U))
<> 144:ef7eb2e8f9f7 573 {
<> 144:ef7eb2e8f9f7 574 return HAL_ERROR;
<> 144:ef7eb2e8f9f7 575 }
<> 144:ef7eb2e8f9f7 576
<> 144:ef7eb2e8f9f7 577 /* Process Locked */
<> 144:ef7eb2e8f9f7 578 __HAL_LOCK(hsc);
<> 144:ef7eb2e8f9f7 579
<> 144:ef7eb2e8f9f7 580 hsc->pTxBuffPtr = pData;
<> 144:ef7eb2e8f9f7 581 hsc->TxXferSize = Size;
<> 144:ef7eb2e8f9f7 582 hsc->TxXferCount = Size;
<> 144:ef7eb2e8f9f7 583
<> 144:ef7eb2e8f9f7 584 hsc->ErrorCode = HAL_SMARTCARD_ERROR_NONE;
<> 144:ef7eb2e8f9f7 585 hsc->gState = HAL_SMARTCARD_STATE_BUSY_TX;
<> 144:ef7eb2e8f9f7 586
<> 144:ef7eb2e8f9f7 587 /* Set the SMARTCARD DMA transfer complete callback */
<> 144:ef7eb2e8f9f7 588 hsc->hdmatx->XferCpltCallback = SMARTCARD_DMATransmitCplt;
<> 144:ef7eb2e8f9f7 589
<> 144:ef7eb2e8f9f7 590 /* Set the SMARTCARD error callback */
<> 144:ef7eb2e8f9f7 591 hsc->hdmatx->XferErrorCallback = SMARTCARD_DMAError;
<> 144:ef7eb2e8f9f7 592
<> 144:ef7eb2e8f9f7 593 /* Set the DMA abort callback */
<> 144:ef7eb2e8f9f7 594 hsc->hdmatx->XferAbortCallback = NULL;
<> 144:ef7eb2e8f9f7 595
<> 144:ef7eb2e8f9f7 596 /* Enable the SMARTCARD transmit DMA Stream */
<> 144:ef7eb2e8f9f7 597 tmp = (uint32_t*)&pData;
<> 144:ef7eb2e8f9f7 598 HAL_DMA_Start_IT(hsc->hdmatx, *(uint32_t*)tmp, (uint32_t)&hsc->Instance->TDR, Size);
<> 144:ef7eb2e8f9f7 599
<> 144:ef7eb2e8f9f7 600 /* Clear the TC flag in the SR register by writing 0 to it */
<> 144:ef7eb2e8f9f7 601 __HAL_SMARTCARD_CLEAR_IT(hsc, SMARTCARD_FLAG_TC);
<> 144:ef7eb2e8f9f7 602
<> 144:ef7eb2e8f9f7 603 /* Process Unlocked */
<> 144:ef7eb2e8f9f7 604 __HAL_UNLOCK(hsc);
<> 144:ef7eb2e8f9f7 605
<> 144:ef7eb2e8f9f7 606 /* Enable the DMA transfer for transmit request by setting the DMAT bit
<> 144:ef7eb2e8f9f7 607 in the SMARTCARD associated USART CR3 register */
<> 144:ef7eb2e8f9f7 608 SET_BIT(hsc->Instance->CR3, USART_CR3_DMAT);
<> 144:ef7eb2e8f9f7 609
<> 144:ef7eb2e8f9f7 610 return HAL_OK;
<> 144:ef7eb2e8f9f7 611 }
<> 144:ef7eb2e8f9f7 612 else
<> 144:ef7eb2e8f9f7 613 {
<> 144:ef7eb2e8f9f7 614 return HAL_BUSY;
<> 144:ef7eb2e8f9f7 615 }
<> 144:ef7eb2e8f9f7 616 }
<> 144:ef7eb2e8f9f7 617
<> 144:ef7eb2e8f9f7 618 /**
<> 144:ef7eb2e8f9f7 619 * @brief Receive an amount of data in DMA mode
<> 144:ef7eb2e8f9f7 620 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 621 * @param pData: pointer to data buffer
<> 144:ef7eb2e8f9f7 622 * @param Size: amount of data to be received
<> 144:ef7eb2e8f9f7 623 * @note The SMARTCARD-associated USART parity is enabled (PCE = 1),
<> 144:ef7eb2e8f9f7 624 * the received data contain the parity bit (MSB position)
<> 144:ef7eb2e8f9f7 625 * @retval HAL status
<> 144:ef7eb2e8f9f7 626 */
<> 144:ef7eb2e8f9f7 627 HAL_StatusTypeDef HAL_SMARTCARD_Receive_DMA(SMARTCARD_HandleTypeDef *hsc, uint8_t *pData, uint16_t Size)
<> 144:ef7eb2e8f9f7 628 {
<> 144:ef7eb2e8f9f7 629 uint32_t *tmp;
<> 144:ef7eb2e8f9f7 630
<> 144:ef7eb2e8f9f7 631 /* Check that a Rx process is not already ongoing */
<> 144:ef7eb2e8f9f7 632 if(hsc->RxState == HAL_SMARTCARD_STATE_READY)
<> 144:ef7eb2e8f9f7 633 {
<> 144:ef7eb2e8f9f7 634 if((pData == NULL) || (Size == 0U))
<> 144:ef7eb2e8f9f7 635 {
<> 144:ef7eb2e8f9f7 636 return HAL_ERROR;
<> 144:ef7eb2e8f9f7 637 }
<> 144:ef7eb2e8f9f7 638
<> 144:ef7eb2e8f9f7 639 /* Process Locked */
<> 144:ef7eb2e8f9f7 640 __HAL_LOCK(hsc);
<> 144:ef7eb2e8f9f7 641
<> 144:ef7eb2e8f9f7 642 hsc->pRxBuffPtr = pData;
<> 144:ef7eb2e8f9f7 643 hsc->RxXferSize = Size;
<> 144:ef7eb2e8f9f7 644
<> 144:ef7eb2e8f9f7 645 hsc->ErrorCode = HAL_SMARTCARD_ERROR_NONE;
<> 144:ef7eb2e8f9f7 646 hsc->RxState = HAL_SMARTCARD_STATE_BUSY_RX;
<> 144:ef7eb2e8f9f7 647
<> 144:ef7eb2e8f9f7 648 /* Set the SMARTCARD DMA transfer complete callback */
<> 144:ef7eb2e8f9f7 649 hsc->hdmarx->XferCpltCallback = SMARTCARD_DMAReceiveCplt;
<> 144:ef7eb2e8f9f7 650
<> 144:ef7eb2e8f9f7 651 /* Set the SMARTCARD DMA error callback */
<> 144:ef7eb2e8f9f7 652 hsc->hdmarx->XferErrorCallback = SMARTCARD_DMAError;
<> 144:ef7eb2e8f9f7 653
<> 144:ef7eb2e8f9f7 654 /* Set the DMA abort callback */
<> 144:ef7eb2e8f9f7 655 hsc->hdmatx->XferAbortCallback = NULL;
<> 144:ef7eb2e8f9f7 656
<> 144:ef7eb2e8f9f7 657 /* Enable the DMA Stream */
<> 144:ef7eb2e8f9f7 658 tmp = (uint32_t*)&pData;
<> 144:ef7eb2e8f9f7 659 HAL_DMA_Start_IT(hsc->hdmarx, (uint32_t)&hsc->Instance->RDR, *(uint32_t*)tmp, Size);
<> 144:ef7eb2e8f9f7 660
<> 144:ef7eb2e8f9f7 661 /* Process Unlocked */
<> 144:ef7eb2e8f9f7 662 __HAL_UNLOCK(hsc);
<> 144:ef7eb2e8f9f7 663
<> 144:ef7eb2e8f9f7 664 /* Enable the SMARTCARD Parity Error Interrupt */
<> 144:ef7eb2e8f9f7 665 SET_BIT(hsc->Instance->CR1, USART_CR1_PEIE);
<> 144:ef7eb2e8f9f7 666
<> 144:ef7eb2e8f9f7 667 /* Enable the SMARTCARD Error Interrupt: (Frame error, noise error, overrun error) */
<> 144:ef7eb2e8f9f7 668 SET_BIT(hsc->Instance->CR3, USART_CR3_EIE);
<> 144:ef7eb2e8f9f7 669
<> 144:ef7eb2e8f9f7 670 /* Enable the DMA transfer for the receiver request by setting the DMAR bit
<> 144:ef7eb2e8f9f7 671 in the SMARTCARD associated USART CR3 register */
<> 144:ef7eb2e8f9f7 672 SET_BIT(hsc->Instance->CR3, USART_CR3_DMAR);
<> 144:ef7eb2e8f9f7 673
<> 144:ef7eb2e8f9f7 674 return HAL_OK;
<> 144:ef7eb2e8f9f7 675 }
<> 144:ef7eb2e8f9f7 676 else
<> 144:ef7eb2e8f9f7 677 {
<> 144:ef7eb2e8f9f7 678 return HAL_BUSY;
<> 144:ef7eb2e8f9f7 679 }
<> 144:ef7eb2e8f9f7 680 }
<> 144:ef7eb2e8f9f7 681
<> 144:ef7eb2e8f9f7 682 /**
<> 144:ef7eb2e8f9f7 683 * @brief SMARTCARD interrupt requests handling.
<> 144:ef7eb2e8f9f7 684 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 685 * @retval None
<> 144:ef7eb2e8f9f7 686 */
<> 144:ef7eb2e8f9f7 687 void HAL_SMARTCARD_IRQHandler(SMARTCARD_HandleTypeDef *hsc)
<> 144:ef7eb2e8f9f7 688 {
<> 144:ef7eb2e8f9f7 689 uint32_t isrflags = READ_REG(hsc->Instance->ISR);
<> 144:ef7eb2e8f9f7 690 uint32_t cr1its = READ_REG(hsc->Instance->CR1);
<> 144:ef7eb2e8f9f7 691 uint32_t cr3its = READ_REG(hsc->Instance->CR3);
<> 144:ef7eb2e8f9f7 692 uint32_t dmarequest = 0x00U;
<> 144:ef7eb2e8f9f7 693 uint32_t errorflags = 0x00U;
<> 144:ef7eb2e8f9f7 694
<> 144:ef7eb2e8f9f7 695 /* If no error occurs */
<> 144:ef7eb2e8f9f7 696 errorflags = (isrflags & (uint32_t)(USART_ISR_PE | USART_ISR_FE | USART_ISR_ORE | USART_ISR_NE));
<> 144:ef7eb2e8f9f7 697 if(errorflags == RESET)
<> 144:ef7eb2e8f9f7 698 {
<> 144:ef7eb2e8f9f7 699 /* SMARTCARD in mode Receiver -------------------------------------------------*/
<> 144:ef7eb2e8f9f7 700 if(((isrflags & USART_ISR_RXNE) != RESET) && ((cr1its & USART_CR1_RXNEIE) != RESET))
<> 144:ef7eb2e8f9f7 701 {
<> 144:ef7eb2e8f9f7 702 SMARTCARD_Receive_IT(hsc);
<> 144:ef7eb2e8f9f7 703 return;
<> 144:ef7eb2e8f9f7 704 }
<> 144:ef7eb2e8f9f7 705 }
<> 144:ef7eb2e8f9f7 706
<> 144:ef7eb2e8f9f7 707 /* If some errors occur */
<> 144:ef7eb2e8f9f7 708 if((errorflags != RESET) && ((cr3its & (USART_CR3_EIE | USART_CR1_PEIE)) != RESET))
<> 144:ef7eb2e8f9f7 709 {
<> 144:ef7eb2e8f9f7 710 /* SMARTCARD parity error interrupt occurred ---------------------------*/
<> 144:ef7eb2e8f9f7 711 if(((isrflags & SMARTCARD_FLAG_PE) != RESET) && ((cr1its & USART_CR1_PEIE) != RESET))
<> 144:ef7eb2e8f9f7 712 {
<> 144:ef7eb2e8f9f7 713 hsc->ErrorCode |= HAL_SMARTCARD_ERROR_PE;
<> 144:ef7eb2e8f9f7 714 }
<> 144:ef7eb2e8f9f7 715
<> 144:ef7eb2e8f9f7 716 /* SMARTCARD frame error interrupt occurred ----------------------------*/
<> 144:ef7eb2e8f9f7 717 if(((isrflags & SMARTCARD_FLAG_FE) != RESET) && ((cr3its & USART_CR3_EIE) != RESET))
<> 144:ef7eb2e8f9f7 718 {
<> 144:ef7eb2e8f9f7 719 hsc->ErrorCode |= HAL_SMARTCARD_ERROR_FE;
<> 144:ef7eb2e8f9f7 720 }
<> 144:ef7eb2e8f9f7 721
<> 144:ef7eb2e8f9f7 722 /* SMARTCARD noise error interrupt occurred ----------------------------*/
<> 144:ef7eb2e8f9f7 723 if(((isrflags & SMARTCARD_FLAG_NE) != RESET) && ((cr3its & USART_CR3_EIE) != RESET))
<> 144:ef7eb2e8f9f7 724 {
<> 144:ef7eb2e8f9f7 725 hsc->ErrorCode |= HAL_SMARTCARD_ERROR_NE;
<> 144:ef7eb2e8f9f7 726 }
<> 144:ef7eb2e8f9f7 727
<> 144:ef7eb2e8f9f7 728 /* SMARTCARD Over-Run interrupt occurred -------------------------------*/
<> 144:ef7eb2e8f9f7 729 if(((isrflags & SMARTCARD_FLAG_ORE) != RESET) && ((cr3its & USART_CR3_EIE) != RESET))
<> 144:ef7eb2e8f9f7 730 {
<> 144:ef7eb2e8f9f7 731 hsc->ErrorCode |= HAL_SMARTCARD_ERROR_ORE;
<> 144:ef7eb2e8f9f7 732 }
<> 144:ef7eb2e8f9f7 733 /* Call the Error call Back in case of Errors */
<> 144:ef7eb2e8f9f7 734 if(hsc->ErrorCode != HAL_SMARTCARD_ERROR_NONE)
<> 144:ef7eb2e8f9f7 735 {
<> 144:ef7eb2e8f9f7 736 /* SMARTCARD in mode Receiver -----------------------------------------------*/
<> 144:ef7eb2e8f9f7 737 if(((isrflags & USART_ISR_RXNE) != RESET) && ((cr1its & USART_CR1_RXNEIE) != RESET))
<> 144:ef7eb2e8f9f7 738 {
<> 144:ef7eb2e8f9f7 739 SMARTCARD_Receive_IT(hsc);
<> 144:ef7eb2e8f9f7 740 }
<> 144:ef7eb2e8f9f7 741
<> 144:ef7eb2e8f9f7 742 /* If Overrun error occurs, or if any error occurs in DMA mode reception,
<> 144:ef7eb2e8f9f7 743 consider error as blocking */
<> 144:ef7eb2e8f9f7 744 dmarequest = HAL_IS_BIT_SET(hsc->Instance->CR3, USART_CR3_DMAR);
<> 144:ef7eb2e8f9f7 745 if(((hsc->ErrorCode & HAL_SMARTCARD_ERROR_ORE) != RESET) || dmarequest)
<> 144:ef7eb2e8f9f7 746 {
<> 144:ef7eb2e8f9f7 747 /* Blocking error : transfer is aborted
<> 144:ef7eb2e8f9f7 748 Set the SMARTCARD state ready to be able to start again the process,
<> 144:ef7eb2e8f9f7 749 Disable Rx Interrupts, and disable Rx DMA request, if ongoing */
<> 144:ef7eb2e8f9f7 750 SMARTCARD_EndRxTransfer(hsc);
<> 144:ef7eb2e8f9f7 751 /* Disable the SMARTCARD DMA Rx request if enabled */
<> 144:ef7eb2e8f9f7 752 if (HAL_IS_BIT_SET(hsc->Instance->CR3, USART_CR3_DMAR))
<> 144:ef7eb2e8f9f7 753 {
<> 144:ef7eb2e8f9f7 754 CLEAR_BIT(hsc->Instance->CR3, USART_CR3_DMAR);
<> 144:ef7eb2e8f9f7 755
<> 144:ef7eb2e8f9f7 756 /* Abort the SMARTCARD DMA Rx channel */
<> 144:ef7eb2e8f9f7 757 if(hsc->hdmarx != NULL)
<> 144:ef7eb2e8f9f7 758 {
<> 144:ef7eb2e8f9f7 759 /* Set the SMARTCARD DMA Abort callback :
<> 144:ef7eb2e8f9f7 760 will lead to call HAL_SMARTCARD_ErrorCallback() at end of DMA abort procedure */
<> 144:ef7eb2e8f9f7 761 hsc->hdmarx->XferAbortCallback = SMARTCARD_DMAAbortOnError;
<> 144:ef7eb2e8f9f7 762
<> 144:ef7eb2e8f9f7 763 if(HAL_DMA_Abort_IT(hsc->hdmarx) != HAL_OK)
<> 144:ef7eb2e8f9f7 764 {
<> 144:ef7eb2e8f9f7 765 /* Call Directly XferAbortCallback function in case of error */
<> 144:ef7eb2e8f9f7 766 hsc->hdmarx->XferAbortCallback(hsc->hdmarx);
<> 144:ef7eb2e8f9f7 767 }
<> 144:ef7eb2e8f9f7 768 }
<> 144:ef7eb2e8f9f7 769 else
<> 144:ef7eb2e8f9f7 770 {
<> 144:ef7eb2e8f9f7 771 /* Call user error callback */
<> 144:ef7eb2e8f9f7 772 HAL_SMARTCARD_ErrorCallback(hsc);
<> 144:ef7eb2e8f9f7 773 }
<> 144:ef7eb2e8f9f7 774 }
<> 144:ef7eb2e8f9f7 775 else
<> 144:ef7eb2e8f9f7 776 {
<> 144:ef7eb2e8f9f7 777 /* Call user error callback */
<> 144:ef7eb2e8f9f7 778 HAL_SMARTCARD_ErrorCallback(hsc);
<> 144:ef7eb2e8f9f7 779 }
<> 144:ef7eb2e8f9f7 780 }
<> 144:ef7eb2e8f9f7 781 else
<> 144:ef7eb2e8f9f7 782 {
<> 144:ef7eb2e8f9f7 783 /* Call user error callback */
<> 144:ef7eb2e8f9f7 784 HAL_SMARTCARD_ErrorCallback(hsc);
<> 144:ef7eb2e8f9f7 785 hsc->ErrorCode = HAL_SMARTCARD_ERROR_NONE;
<> 144:ef7eb2e8f9f7 786 }
<> 144:ef7eb2e8f9f7 787 }
<> 144:ef7eb2e8f9f7 788 return;
<> 144:ef7eb2e8f9f7 789 } /* End if some error occurs */
<> 144:ef7eb2e8f9f7 790
<> 144:ef7eb2e8f9f7 791 /* SMARTCARD in mode Transmitter -------------------------------------------*/
<> 144:ef7eb2e8f9f7 792 if(((isrflags & SMARTCARD_FLAG_TXE) != RESET) && ((cr1its & USART_CR1_TXEIE) != RESET))
<> 144:ef7eb2e8f9f7 793 {
<> 144:ef7eb2e8f9f7 794 SMARTCARD_Transmit_IT(hsc);
<> 144:ef7eb2e8f9f7 795 return;
<> 144:ef7eb2e8f9f7 796 }
<> 144:ef7eb2e8f9f7 797
<> 144:ef7eb2e8f9f7 798 /* SMARTCARD in mode Transmitter (transmission end) ------------------------*/
<> 144:ef7eb2e8f9f7 799 if(((isrflags & SMARTCARD_FLAG_TC) != RESET) && ((cr1its & USART_CR1_TCIE) != RESET))
<> 144:ef7eb2e8f9f7 800 {
<> 144:ef7eb2e8f9f7 801 /* Disable the SMARTCARD Transmit Complete Interrupt */
<> 144:ef7eb2e8f9f7 802 CLEAR_BIT(hsc->Instance->CR1, USART_CR1_TCIE);
<> 144:ef7eb2e8f9f7 803
<> 144:ef7eb2e8f9f7 804 /* Disable the SMARTCARD Error Interrupt: (Frame error, noise error, overrun error) */
<> 144:ef7eb2e8f9f7 805 CLEAR_BIT(hsc->Instance->CR3, USART_CR3_EIE);
<> 144:ef7eb2e8f9f7 806
<> 144:ef7eb2e8f9f7 807 /* Tx process is ended, restore hsmartcard->gState to Ready */
<> 144:ef7eb2e8f9f7 808 hsc->gState = HAL_SMARTCARD_STATE_READY;
<> 144:ef7eb2e8f9f7 809
<> 144:ef7eb2e8f9f7 810 HAL_SMARTCARD_TxCpltCallback(hsc);
<> 144:ef7eb2e8f9f7 811
<> 144:ef7eb2e8f9f7 812 return;
<> 144:ef7eb2e8f9f7 813 }
<> 144:ef7eb2e8f9f7 814 }
<> 144:ef7eb2e8f9f7 815
<> 144:ef7eb2e8f9f7 816 /**
<> 144:ef7eb2e8f9f7 817 * @brief Tx Transfer completed callbacks
<> 144:ef7eb2e8f9f7 818 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 819 * @retval None
<> 144:ef7eb2e8f9f7 820 */
<> 144:ef7eb2e8f9f7 821 __weak void HAL_SMARTCARD_TxCpltCallback(SMARTCARD_HandleTypeDef *hsc)
<> 144:ef7eb2e8f9f7 822 {
<> 144:ef7eb2e8f9f7 823 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 824 UNUSED(hsc);
<> 144:ef7eb2e8f9f7 825
<> 144:ef7eb2e8f9f7 826 /* NOTE : This function Should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 827 the HAL_SMARTCARD_TxCpltCallback could be implemented in the user file
<> 144:ef7eb2e8f9f7 828 */
<> 144:ef7eb2e8f9f7 829 }
<> 144:ef7eb2e8f9f7 830
<> 144:ef7eb2e8f9f7 831 /**
<> 144:ef7eb2e8f9f7 832 * @brief Rx Transfer completed callbacks
<> 144:ef7eb2e8f9f7 833 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 834 * @retval None
<> 144:ef7eb2e8f9f7 835 */
<> 144:ef7eb2e8f9f7 836 __weak void HAL_SMARTCARD_RxCpltCallback(SMARTCARD_HandleTypeDef *hsc)
<> 144:ef7eb2e8f9f7 837 {
<> 144:ef7eb2e8f9f7 838 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 839 UNUSED(hsc);
<> 144:ef7eb2e8f9f7 840
<> 144:ef7eb2e8f9f7 841 /* NOTE : This function Should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 842 the HAL_SMARTCARD_TxCpltCallback could be implemented in the user file
<> 144:ef7eb2e8f9f7 843 */
<> 144:ef7eb2e8f9f7 844 }
<> 144:ef7eb2e8f9f7 845
<> 144:ef7eb2e8f9f7 846 /**
<> 144:ef7eb2e8f9f7 847 * @brief SMARTCARD error callbacks
<> 144:ef7eb2e8f9f7 848 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 849 * @retval None
<> 144:ef7eb2e8f9f7 850 */
<> 144:ef7eb2e8f9f7 851 __weak void HAL_SMARTCARD_ErrorCallback(SMARTCARD_HandleTypeDef *hsc)
<> 144:ef7eb2e8f9f7 852 {
<> 144:ef7eb2e8f9f7 853 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 854 UNUSED(hsc);
<> 144:ef7eb2e8f9f7 855
<> 144:ef7eb2e8f9f7 856 /* NOTE : This function Should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 857 the HAL_SMARTCARD_ErrorCallback could be implemented in the user file
<> 144:ef7eb2e8f9f7 858 */
<> 144:ef7eb2e8f9f7 859 }
<> 144:ef7eb2e8f9f7 860
<> 144:ef7eb2e8f9f7 861 /**
<> 144:ef7eb2e8f9f7 862 * @}
<> 144:ef7eb2e8f9f7 863 */
<> 144:ef7eb2e8f9f7 864
<> 144:ef7eb2e8f9f7 865 /** @defgroup SMARTCARD_Exported_Functions_Group3 Peripheral State functions
<> 144:ef7eb2e8f9f7 866 * @brief SMARTCARD State functions
<> 144:ef7eb2e8f9f7 867 *
<> 144:ef7eb2e8f9f7 868 @verbatim
<> 144:ef7eb2e8f9f7 869 ===============================================================================
<> 144:ef7eb2e8f9f7 870 ##### Peripheral State and Errors functions #####
<> 144:ef7eb2e8f9f7 871 ===============================================================================
<> 144:ef7eb2e8f9f7 872 [..]
<> 144:ef7eb2e8f9f7 873 This subsection provides a set of functions allowing to initialize the SMARTCARD.
<> 144:ef7eb2e8f9f7 874 (+) HAL_SMARTCARD_GetState() API is helpful to check in run-time the state of the SMARTCARD peripheral
<> 144:ef7eb2e8f9f7 875 (+) SMARTCARD_SetConfig() API configures the SMARTCARD peripheral
<> 144:ef7eb2e8f9f7 876 (+) SMARTCARD_CheckIdleState() API ensures that TEACK and/or REACK are set after initialization
<> 144:ef7eb2e8f9f7 877
<> 144:ef7eb2e8f9f7 878 @endverbatim
<> 144:ef7eb2e8f9f7 879 * @{
<> 144:ef7eb2e8f9f7 880 */
<> 144:ef7eb2e8f9f7 881
<> 144:ef7eb2e8f9f7 882
<> 144:ef7eb2e8f9f7 883 /**
<> 144:ef7eb2e8f9f7 884 * @brief return the SMARTCARD state
<> 144:ef7eb2e8f9f7 885 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 886 * @retval HAL state
<> 144:ef7eb2e8f9f7 887 */
<> 144:ef7eb2e8f9f7 888 HAL_SMARTCARD_StateTypeDef HAL_SMARTCARD_GetState(SMARTCARD_HandleTypeDef *hsc)
<> 144:ef7eb2e8f9f7 889 {
<> 144:ef7eb2e8f9f7 890 uint32_t temp1= 0x00U, temp2 = 0x00U;
<> 144:ef7eb2e8f9f7 891 temp1 = hsc->gState;
<> 144:ef7eb2e8f9f7 892 temp2 = hsc->RxState;
<> 144:ef7eb2e8f9f7 893
<> 144:ef7eb2e8f9f7 894 return (HAL_SMARTCARD_StateTypeDef)(temp1 | temp2);
<> 144:ef7eb2e8f9f7 895 }
<> 144:ef7eb2e8f9f7 896
<> 144:ef7eb2e8f9f7 897 /**
<> 144:ef7eb2e8f9f7 898 * @brief Return the SMARTCARD error code
<> 144:ef7eb2e8f9f7 899 * @param hsc : pointer to a SMARTCARD_HandleTypeDef structure that contains
<> 144:ef7eb2e8f9f7 900 * the configuration information for the specified SMARTCARD.
<> 144:ef7eb2e8f9f7 901 * @retval SMARTCARD Error Code
<> 144:ef7eb2e8f9f7 902 */
<> 144:ef7eb2e8f9f7 903 uint32_t HAL_SMARTCARD_GetError(SMARTCARD_HandleTypeDef *hsc)
<> 144:ef7eb2e8f9f7 904 {
<> 144:ef7eb2e8f9f7 905 return hsc->ErrorCode;
<> 144:ef7eb2e8f9f7 906 }
<> 144:ef7eb2e8f9f7 907
<> 144:ef7eb2e8f9f7 908 /**
<> 144:ef7eb2e8f9f7 909 * @}
<> 144:ef7eb2e8f9f7 910 */
<> 144:ef7eb2e8f9f7 911
<> 144:ef7eb2e8f9f7 912 /**
<> 144:ef7eb2e8f9f7 913 * @brief Send an amount of data in non blocking mode
<> 144:ef7eb2e8f9f7 914 * @param hsc: SMARTCARD handle.
<> 144:ef7eb2e8f9f7 915 * Function called under interruption only, once
<> 144:ef7eb2e8f9f7 916 * interruptions have been enabled by HAL_SMARTCARD_Transmit_IT()
<> 144:ef7eb2e8f9f7 917 * @retval HAL status
<> 144:ef7eb2e8f9f7 918 */
<> 144:ef7eb2e8f9f7 919 static HAL_StatusTypeDef SMARTCARD_Transmit_IT(SMARTCARD_HandleTypeDef *hsc)
<> 144:ef7eb2e8f9f7 920 {
<> 144:ef7eb2e8f9f7 921 if(hsc->gState == HAL_SMARTCARD_STATE_BUSY_TX)
<> 144:ef7eb2e8f9f7 922 {
<> 144:ef7eb2e8f9f7 923 if(hsc->TxXferCount == 0)
<> 144:ef7eb2e8f9f7 924 {
<> 144:ef7eb2e8f9f7 925 /* Disable the SMARTCARD Transmit Complete Interrupt */
<> 144:ef7eb2e8f9f7 926 CLEAR_BIT(hsc->Instance->CR1, USART_CR1_TXEIE);
<> 144:ef7eb2e8f9f7 927
<> 144:ef7eb2e8f9f7 928 /* Disable the SMARTCARD Error Interrupt: (Frame error, noise error, overrun error) */
<> 144:ef7eb2e8f9f7 929 CLEAR_BIT(hsc->Instance->CR3, USART_CR3_EIE);
<> 144:ef7eb2e8f9f7 930
<> 144:ef7eb2e8f9f7 931 /* Tx process is ended, restore hsmartcard->gState to Ready */
<> 144:ef7eb2e8f9f7 932 hsc->gState = HAL_SMARTCARD_STATE_READY;
<> 144:ef7eb2e8f9f7 933 }
<> 144:ef7eb2e8f9f7 934
<> 144:ef7eb2e8f9f7 935 HAL_SMARTCARD_TxCpltCallback(hsc);
<> 144:ef7eb2e8f9f7 936
<> 144:ef7eb2e8f9f7 937 return HAL_OK;
<> 144:ef7eb2e8f9f7 938 }
<> 144:ef7eb2e8f9f7 939 else
<> 144:ef7eb2e8f9f7 940 {
<> 144:ef7eb2e8f9f7 941 hsc->Instance->TDR = (*hsc->pTxBuffPtr++ & (uint8_t)0xFFU);
<> 144:ef7eb2e8f9f7 942 hsc->TxXferCount--;
<> 144:ef7eb2e8f9f7 943
<> 144:ef7eb2e8f9f7 944 return HAL_OK;
<> 144:ef7eb2e8f9f7 945 }
<> 144:ef7eb2e8f9f7 946 }
<> 144:ef7eb2e8f9f7 947
<> 144:ef7eb2e8f9f7 948 /**
<> 144:ef7eb2e8f9f7 949 * @brief Receive an amount of data in non blocking mode
<> 144:ef7eb2e8f9f7 950 * @param hsc: SMARTCARD handle.
<> 144:ef7eb2e8f9f7 951 * Function called under interruption only, once
<> 144:ef7eb2e8f9f7 952 * interruptions have been enabled by HAL_SMARTCARD_Receive_IT()
<> 144:ef7eb2e8f9f7 953 * @retval HAL status
<> 144:ef7eb2e8f9f7 954 */
<> 144:ef7eb2e8f9f7 955 static HAL_StatusTypeDef SMARTCARD_Receive_IT(SMARTCARD_HandleTypeDef *hsc)
<> 144:ef7eb2e8f9f7 956 {
<> 144:ef7eb2e8f9f7 957 /* Check that a Rx process is ongoing */
<> 144:ef7eb2e8f9f7 958 if(hsc->RxState == HAL_SMARTCARD_STATE_BUSY_RX)
<> 144:ef7eb2e8f9f7 959 {
<> 144:ef7eb2e8f9f7 960 *hsc->pRxBuffPtr++ = (uint8_t)(hsc->Instance->RDR & (uint8_t)0xFFU);
<> 144:ef7eb2e8f9f7 961
<> 144:ef7eb2e8f9f7 962 if(--hsc->RxXferCount == 0)
<> 144:ef7eb2e8f9f7 963 {
<> 144:ef7eb2e8f9f7 964 CLEAR_BIT(hsc->Instance->CR1, USART_CR1_RXNEIE);
<> 144:ef7eb2e8f9f7 965
<> 144:ef7eb2e8f9f7 966 /* Disable the SMARTCARD Parity Error Interrupt */
<> 144:ef7eb2e8f9f7 967 CLEAR_BIT(hsc->Instance->CR1, USART_CR1_PEIE);
<> 144:ef7eb2e8f9f7 968
<> 144:ef7eb2e8f9f7 969 /* Disable the SMARTCARD Error Interrupt: (Frame error, noise error, overrun error) */
<> 144:ef7eb2e8f9f7 970 CLEAR_BIT(hsc->Instance->CR3, USART_CR3_EIE);
<> 144:ef7eb2e8f9f7 971
<> 144:ef7eb2e8f9f7 972 hsc->RxState = HAL_SMARTCARD_STATE_READY;
<> 144:ef7eb2e8f9f7 973
<> 144:ef7eb2e8f9f7 974 HAL_SMARTCARD_RxCpltCallback(hsc);
<> 144:ef7eb2e8f9f7 975
<> 144:ef7eb2e8f9f7 976 return HAL_OK;
<> 144:ef7eb2e8f9f7 977 }
<> 144:ef7eb2e8f9f7 978
<> 144:ef7eb2e8f9f7 979 return HAL_OK;
<> 144:ef7eb2e8f9f7 980 }
<> 144:ef7eb2e8f9f7 981 else
<> 144:ef7eb2e8f9f7 982 {
<> 144:ef7eb2e8f9f7 983 return HAL_BUSY;
<> 144:ef7eb2e8f9f7 984 }
<> 144:ef7eb2e8f9f7 985 }
<> 144:ef7eb2e8f9f7 986
<> 144:ef7eb2e8f9f7 987 /**
<> 144:ef7eb2e8f9f7 988 * @brief Configure the SMARTCARD associated USART peripheral
<> 144:ef7eb2e8f9f7 989 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 990 * @retval None
<> 144:ef7eb2e8f9f7 991 */
<> 144:ef7eb2e8f9f7 992 static void SMARTCARD_SetConfig(SMARTCARD_HandleTypeDef *hsc)
<> 144:ef7eb2e8f9f7 993 {
<> 144:ef7eb2e8f9f7 994 uint32_t tmpreg = 0x00000000U;
<> 144:ef7eb2e8f9f7 995 uint32_t clocksource = 0x00000000U;
<> 144:ef7eb2e8f9f7 996
<> 144:ef7eb2e8f9f7 997 /* Check the parameters */
<> 144:ef7eb2e8f9f7 998 assert_param(IS_SMARTCARD_INSTANCE(hsc->Instance));
<> 144:ef7eb2e8f9f7 999 assert_param(IS_SMARTCARD_BAUDRATE(hsc->Init.BaudRate));
<> 144:ef7eb2e8f9f7 1000 assert_param(IS_SMARTCARD_WORD_LENGTH(hsc->Init.WordLength));
<> 144:ef7eb2e8f9f7 1001 assert_param(IS_SMARTCARD_STOPBITS(hsc->Init.StopBits));
<> 144:ef7eb2e8f9f7 1002 assert_param(IS_SMARTCARD_PARITY(hsc->Init.Parity));
<> 144:ef7eb2e8f9f7 1003 assert_param(IS_SMARTCARD_MODE(hsc->Init.Mode));
<> 144:ef7eb2e8f9f7 1004 assert_param(IS_SMARTCARD_POLARITY(hsc->Init.CLKPolarity));
<> 144:ef7eb2e8f9f7 1005 assert_param(IS_SMARTCARD_PHASE(hsc->Init.CLKPhase));
<> 144:ef7eb2e8f9f7 1006 assert_param(IS_SMARTCARD_LASTBIT(hsc->Init.CLKLastBit));
<> 144:ef7eb2e8f9f7 1007 assert_param(IS_SMARTCARD_ONE_BIT_SAMPLE(hsc->Init.OneBitSampling));
<> 144:ef7eb2e8f9f7 1008 assert_param(IS_SMARTCARD_NACK(hsc->Init.NACKState));
<> 144:ef7eb2e8f9f7 1009 assert_param(IS_SMARTCARD_TIMEOUT(hsc->Init.TimeOutEnable));
<> 144:ef7eb2e8f9f7 1010 assert_param(IS_SMARTCARD_AUTORETRY_COUNT(hsc->Init.AutoRetryCount));
<> 144:ef7eb2e8f9f7 1011
<> 144:ef7eb2e8f9f7 1012 /*-------------------------- USART CR1 Configuration -----------------------*/
<> 144:ef7eb2e8f9f7 1013 /* In SmartCard mode, M and PCE are forced to 1 (8 bits + parity).
<> 144:ef7eb2e8f9f7 1014 * Oversampling is forced to 16 (OVER8 = 0).
<> 144:ef7eb2e8f9f7 1015 * Configure the Parity and Mode:
<> 144:ef7eb2e8f9f7 1016 * set PS bit according to hsc->Init.Parity value
<> 144:ef7eb2e8f9f7 1017 * set TE and RE bits according to hsc->Init.Mode value */
<> 144:ef7eb2e8f9f7 1018 tmpreg = (uint32_t) hsc->Init.Parity | hsc->Init.Mode;
<> 144:ef7eb2e8f9f7 1019 /* in case of TX-only mode, if NACK is enabled, the USART must be able to monitor
<> 144:ef7eb2e8f9f7 1020 the bidirectional line to detect a NACK signal in case of parity error.
<> 144:ef7eb2e8f9f7 1021 Therefore, the receiver block must be enabled as well (RE bit must be set). */
<> 144:ef7eb2e8f9f7 1022 if((hsc->Init.Mode == SMARTCARD_MODE_TX) && (hsc->Init.NACKState == SMARTCARD_NACK_ENABLE))
<> 144:ef7eb2e8f9f7 1023 {
<> 144:ef7eb2e8f9f7 1024 tmpreg |= USART_CR1_RE;
<> 144:ef7eb2e8f9f7 1025 }
<> 144:ef7eb2e8f9f7 1026 tmpreg |= (uint32_t) hsc->Init.WordLength;
<> 144:ef7eb2e8f9f7 1027 MODIFY_REG(hsc->Instance->CR1, USART_CR1_FIELDS, tmpreg);
<> 144:ef7eb2e8f9f7 1028
<> 144:ef7eb2e8f9f7 1029 /*-------------------------- USART CR2 Configuration -----------------------*/
<> 144:ef7eb2e8f9f7 1030 /* Stop bits are forced to 1.5 (STOP = 11) */
<> 144:ef7eb2e8f9f7 1031 tmpreg = hsc->Init.StopBits;
<> 144:ef7eb2e8f9f7 1032 /* Synchronous mode is activated by default */
<> 144:ef7eb2e8f9f7 1033 tmpreg |= (uint32_t) USART_CR2_CLKEN | hsc->Init.CLKPolarity;
<> 144:ef7eb2e8f9f7 1034 tmpreg |= (uint32_t) hsc->Init.CLKPhase | hsc->Init.CLKLastBit;
<> 144:ef7eb2e8f9f7 1035 tmpreg |= (uint32_t) hsc->Init.TimeOutEnable;
<> 144:ef7eb2e8f9f7 1036 MODIFY_REG(hsc->Instance->CR2, USART_CR2_FIELDS, tmpreg);
<> 144:ef7eb2e8f9f7 1037
<> 144:ef7eb2e8f9f7 1038 /*-------------------------- USART CR3 Configuration -----------------------*/
<> 144:ef7eb2e8f9f7 1039 /* Configure
<> 144:ef7eb2e8f9f7 1040 * - one-bit sampling method versus three samples' majority rule
<> 144:ef7eb2e8f9f7 1041 * according to hsc->Init.OneBitSampling
<> 144:ef7eb2e8f9f7 1042 * - NACK transmission in case of parity error according
<> 144:ef7eb2e8f9f7 1043 * to hsc->Init.NACKEnable
<> 144:ef7eb2e8f9f7 1044 * - autoretry counter according to hsc->Init.AutoRetryCount */
<> 144:ef7eb2e8f9f7 1045 tmpreg = (uint32_t) hsc->Init.OneBitSampling | hsc->Init.NACKState;
<> 144:ef7eb2e8f9f7 1046 tmpreg |= (uint32_t) (hsc->Init.AutoRetryCount << SMARTCARD_CR3_SCARCNT_LSB_POS);
<> 144:ef7eb2e8f9f7 1047 MODIFY_REG(hsc->Instance-> CR3,USART_CR3_FIELDS, tmpreg);
<> 144:ef7eb2e8f9f7 1048
<> 144:ef7eb2e8f9f7 1049 /*-------------------------- USART GTPR Configuration ----------------------*/
<> 144:ef7eb2e8f9f7 1050 tmpreg = (uint32_t) (hsc->Init.Prescaler | (hsc->Init.GuardTime << SMARTCARD_GTPR_GT_LSB_POS));
<> 144:ef7eb2e8f9f7 1051 MODIFY_REG(hsc->Instance->GTPR, (uint32_t)(USART_GTPR_GT|USART_GTPR_PSC), tmpreg);
<> 144:ef7eb2e8f9f7 1052
<> 144:ef7eb2e8f9f7 1053 /*-------------------------- USART RTOR Configuration ----------------------*/
<> 144:ef7eb2e8f9f7 1054 tmpreg = (uint32_t) (hsc->Init.BlockLength << SMARTCARD_RTOR_BLEN_LSB_POS);
<> 144:ef7eb2e8f9f7 1055 if(hsc->Init.TimeOutEnable == SMARTCARD_TIMEOUT_ENABLE)
<> 144:ef7eb2e8f9f7 1056 {
<> 144:ef7eb2e8f9f7 1057 assert_param(IS_SMARTCARD_TIMEOUT_VALUE(hsc->Init.TimeOutValue));
<> 144:ef7eb2e8f9f7 1058 tmpreg |= (uint32_t) hsc->Init.TimeOutValue;
<> 144:ef7eb2e8f9f7 1059 }
<> 144:ef7eb2e8f9f7 1060 MODIFY_REG(hsc->Instance->RTOR, (USART_RTOR_RTO|USART_RTOR_BLEN), tmpreg);
<> 144:ef7eb2e8f9f7 1061
<> 144:ef7eb2e8f9f7 1062 /*-------------------------- USART BRR Configuration -----------------------*/
<> 144:ef7eb2e8f9f7 1063 SMARTCARD_GETCLOCKSOURCE(hsc, clocksource);
<> 144:ef7eb2e8f9f7 1064 switch (clocksource)
<> 144:ef7eb2e8f9f7 1065 {
<> 144:ef7eb2e8f9f7 1066 case SMARTCARD_CLOCKSOURCE_PCLK1:
<> 144:ef7eb2e8f9f7 1067 hsc->Instance->BRR = (uint16_t)((HAL_RCC_GetPCLK1Freq() + (hsc->Init.BaudRate/2))/ hsc->Init.BaudRate);
<> 144:ef7eb2e8f9f7 1068 break;
<> 144:ef7eb2e8f9f7 1069 case SMARTCARD_CLOCKSOURCE_PCLK2:
<> 144:ef7eb2e8f9f7 1070 hsc->Instance->BRR = (uint16_t)((HAL_RCC_GetPCLK2Freq() + (hsc->Init.BaudRate/2))/ hsc->Init.BaudRate);
<> 144:ef7eb2e8f9f7 1071 break;
<> 144:ef7eb2e8f9f7 1072 case SMARTCARD_CLOCKSOURCE_HSI:
<> 144:ef7eb2e8f9f7 1073 hsc->Instance->BRR = (uint16_t)((HSI_VALUE + (hsc->Init.BaudRate/2))/ hsc->Init.BaudRate);
<> 144:ef7eb2e8f9f7 1074 break;
<> 144:ef7eb2e8f9f7 1075 case SMARTCARD_CLOCKSOURCE_SYSCLK:
<> 144:ef7eb2e8f9f7 1076 hsc->Instance->BRR = (uint16_t)((HAL_RCC_GetSysClockFreq() + (hsc->Init.BaudRate/2))/ hsc->Init.BaudRate);
<> 144:ef7eb2e8f9f7 1077 break;
<> 144:ef7eb2e8f9f7 1078 case SMARTCARD_CLOCKSOURCE_LSE:
<> 144:ef7eb2e8f9f7 1079 hsc->Instance->BRR = (uint16_t)((LSE_VALUE + (hsc->Init.BaudRate/2))/ hsc->Init.BaudRate);
<> 144:ef7eb2e8f9f7 1080 break;
<> 144:ef7eb2e8f9f7 1081 default:
<> 144:ef7eb2e8f9f7 1082 break;
<> 144:ef7eb2e8f9f7 1083 }
<> 144:ef7eb2e8f9f7 1084 }
<> 144:ef7eb2e8f9f7 1085
<> 144:ef7eb2e8f9f7 1086 /**
<> 144:ef7eb2e8f9f7 1087 * @brief Check the SMARTCARD Idle State
<> 144:ef7eb2e8f9f7 1088 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 1089 * @retval HAL status
<> 144:ef7eb2e8f9f7 1090 */
<> 144:ef7eb2e8f9f7 1091 static HAL_StatusTypeDef SMARTCARD_CheckIdleState(SMARTCARD_HandleTypeDef *hsc)
<> 144:ef7eb2e8f9f7 1092 {
<> 144:ef7eb2e8f9f7 1093 uint32_t tickstart = 0U;
<> 144:ef7eb2e8f9f7 1094
<> 144:ef7eb2e8f9f7 1095 /* Initialize the SMARTCARD ErrorCode */
<> 144:ef7eb2e8f9f7 1096 hsc->ErrorCode = HAL_SMARTCARD_ERROR_NONE;
<> 144:ef7eb2e8f9f7 1097
<> 144:ef7eb2e8f9f7 1098 /* Init tickstart for timeout managment*/
<> 144:ef7eb2e8f9f7 1099 tickstart = HAL_GetTick();
<> 144:ef7eb2e8f9f7 1100
<> 144:ef7eb2e8f9f7 1101 /* Check if the Transmitter is enabled */
<> 144:ef7eb2e8f9f7 1102 if((hsc->Instance->CR1 & USART_CR1_TE) == USART_CR1_TE)
<> 144:ef7eb2e8f9f7 1103 {
<> 144:ef7eb2e8f9f7 1104 /* Wait until TEACK flag is set */
<> 144:ef7eb2e8f9f7 1105 if(SMARTCARD_WaitOnFlagUntilTimeout(hsc, USART_ISR_TEACK, RESET, tickstart, TEACK_REACK_TIMEOUT) != HAL_OK)
<> 144:ef7eb2e8f9f7 1106 {
<> 144:ef7eb2e8f9f7 1107 return HAL_TIMEOUT;
<> 144:ef7eb2e8f9f7 1108 }
<> 144:ef7eb2e8f9f7 1109 }
<> 144:ef7eb2e8f9f7 1110 /* Check if the Receiver is enabled */
<> 144:ef7eb2e8f9f7 1111 if((hsc->Instance->CR1 & USART_CR1_RE) == USART_CR1_RE)
<> 144:ef7eb2e8f9f7 1112 {
<> 144:ef7eb2e8f9f7 1113 /* Wait until REACK flag is set */
<> 144:ef7eb2e8f9f7 1114 if(SMARTCARD_WaitOnFlagUntilTimeout(hsc, USART_ISR_REACK, RESET, tickstart, TEACK_REACK_TIMEOUT) != HAL_OK)
<> 144:ef7eb2e8f9f7 1115 {
<> 144:ef7eb2e8f9f7 1116 return HAL_TIMEOUT;
<> 144:ef7eb2e8f9f7 1117 }
<> 144:ef7eb2e8f9f7 1118 }
<> 144:ef7eb2e8f9f7 1119
<> 144:ef7eb2e8f9f7 1120 /* Process Unlocked */
<> 144:ef7eb2e8f9f7 1121 __HAL_UNLOCK(hsc);
<> 144:ef7eb2e8f9f7 1122
<> 144:ef7eb2e8f9f7 1123 /* Initialize the SMARTCARD state*/
<> 144:ef7eb2e8f9f7 1124 hsc->gState= HAL_SMARTCARD_STATE_READY;
<> 144:ef7eb2e8f9f7 1125 hsc->RxState= HAL_SMARTCARD_STATE_READY;
<> 144:ef7eb2e8f9f7 1126
<> 144:ef7eb2e8f9f7 1127 return HAL_OK;
<> 144:ef7eb2e8f9f7 1128 }
<> 144:ef7eb2e8f9f7 1129
<> 144:ef7eb2e8f9f7 1130 /**
<> 144:ef7eb2e8f9f7 1131 * @brief Configure the SMARTCARD associated USART peripheral advanced features
<> 144:ef7eb2e8f9f7 1132 * @param hsc: SMARTCARD handle
<> 144:ef7eb2e8f9f7 1133 * @retval None
<> 144:ef7eb2e8f9f7 1134 */
<> 144:ef7eb2e8f9f7 1135 static void SMARTCARD_AdvFeatureConfig(SMARTCARD_HandleTypeDef *hsc)
<> 144:ef7eb2e8f9f7 1136 {
<> 144:ef7eb2e8f9f7 1137 /* Check whether the set of advanced features to configure is properly set */
<> 144:ef7eb2e8f9f7 1138 assert_param(IS_SMARTCARD_ADVFEATURE_INIT(hsc->AdvancedInit.AdvFeatureInit));
<> 144:ef7eb2e8f9f7 1139
<> 144:ef7eb2e8f9f7 1140 /* if required, configure TX pin active level inversion */
<> 144:ef7eb2e8f9f7 1141 if(HAL_IS_BIT_SET(hsc->AdvancedInit.AdvFeatureInit, SMARTCARD_ADVFEATURE_TXINVERT_INIT))
<> 144:ef7eb2e8f9f7 1142 {
<> 144:ef7eb2e8f9f7 1143 assert_param(IS_SMARTCARD_ADVFEATURE_TXINV(hsc->AdvancedInit.TxPinLevelInvert));
<> 144:ef7eb2e8f9f7 1144 MODIFY_REG(hsc->Instance->CR2, USART_CR2_TXINV, hsc->AdvancedInit.TxPinLevelInvert);
<> 144:ef7eb2e8f9f7 1145 }
<> 144:ef7eb2e8f9f7 1146
<> 144:ef7eb2e8f9f7 1147 /* if required, configure RX pin active level inversion */
<> 144:ef7eb2e8f9f7 1148 if(HAL_IS_BIT_SET(hsc->AdvancedInit.AdvFeatureInit, SMARTCARD_ADVFEATURE_RXINVERT_INIT))
<> 144:ef7eb2e8f9f7 1149 {
<> 144:ef7eb2e8f9f7 1150 assert_param(IS_SMARTCARD_ADVFEATURE_RXINV(hsc->AdvancedInit.RxPinLevelInvert));
<> 144:ef7eb2e8f9f7 1151 MODIFY_REG(hsc->Instance->CR2, USART_CR2_RXINV, hsc->AdvancedInit.RxPinLevelInvert);
<> 144:ef7eb2e8f9f7 1152 }
<> 144:ef7eb2e8f9f7 1153
<> 144:ef7eb2e8f9f7 1154 /* if required, configure data inversion */
<> 144:ef7eb2e8f9f7 1155 if(HAL_IS_BIT_SET(hsc->AdvancedInit.AdvFeatureInit, SMARTCARD_ADVFEATURE_DATAINVERT_INIT))
<> 144:ef7eb2e8f9f7 1156 {
<> 144:ef7eb2e8f9f7 1157 assert_param(IS_SMARTCARD_ADVFEATURE_DATAINV(hsc->AdvancedInit.DataInvert));
<> 144:ef7eb2e8f9f7 1158 MODIFY_REG(hsc->Instance->CR2, USART_CR2_DATAINV, hsc->AdvancedInit.DataInvert);
<> 144:ef7eb2e8f9f7 1159 }
<> 144:ef7eb2e8f9f7 1160
<> 144:ef7eb2e8f9f7 1161 /* if required, configure RX/TX pins swap */
<> 144:ef7eb2e8f9f7 1162 if(HAL_IS_BIT_SET(hsc->AdvancedInit.AdvFeatureInit, SMARTCARD_ADVFEATURE_SWAP_INIT))
<> 144:ef7eb2e8f9f7 1163 {
<> 144:ef7eb2e8f9f7 1164 assert_param(IS_SMARTCARD_ADVFEATURE_SWAP(hsc->AdvancedInit.Swap));
<> 144:ef7eb2e8f9f7 1165 MODIFY_REG(hsc->Instance->CR2, USART_CR2_SWAP, hsc->AdvancedInit.Swap);
<> 144:ef7eb2e8f9f7 1166 }
<> 144:ef7eb2e8f9f7 1167
<> 144:ef7eb2e8f9f7 1168 /* if required, configure RX overrun detection disabling */
<> 144:ef7eb2e8f9f7 1169 if(HAL_IS_BIT_SET(hsc->AdvancedInit.AdvFeatureInit, SMARTCARD_ADVFEATURE_RXOVERRUNDISABLE_INIT))
<> 144:ef7eb2e8f9f7 1170 {
<> 144:ef7eb2e8f9f7 1171 assert_param(IS_SMARTCARD_OVERRUN(hsc->AdvancedInit.OverrunDisable));
<> 144:ef7eb2e8f9f7 1172 MODIFY_REG(hsc->Instance->CR3, USART_CR3_OVRDIS, hsc->AdvancedInit.OverrunDisable);
<> 144:ef7eb2e8f9f7 1173 }
<> 144:ef7eb2e8f9f7 1174
<> 144:ef7eb2e8f9f7 1175 /* if required, configure DMA disabling on reception error */
<> 144:ef7eb2e8f9f7 1176 if(HAL_IS_BIT_SET(hsc->AdvancedInit.AdvFeatureInit, SMARTCARD_ADVFEATURE_DMADISABLEONERROR_INIT))
<> 144:ef7eb2e8f9f7 1177 {
<> 144:ef7eb2e8f9f7 1178 assert_param(IS_SMARTCARD_ADVFEATURE_DMAONRXERROR(hsc->AdvancedInit.DMADisableonRxError));
<> 144:ef7eb2e8f9f7 1179 MODIFY_REG(hsc->Instance->CR3, USART_CR3_DDRE, hsc->AdvancedInit.DMADisableonRxError);
<> 144:ef7eb2e8f9f7 1180 }
<> 144:ef7eb2e8f9f7 1181
<> 144:ef7eb2e8f9f7 1182 /* if required, configure MSB first on communication line */
<> 144:ef7eb2e8f9f7 1183 if(HAL_IS_BIT_SET(hsc->AdvancedInit.AdvFeatureInit, SMARTCARD_ADVFEATURE_MSBFIRST_INIT))
<> 144:ef7eb2e8f9f7 1184 {
<> 144:ef7eb2e8f9f7 1185 assert_param(IS_SMARTCARD_ADVFEATURE_MSBFIRST(hsc->AdvancedInit.MSBFirst));
<> 144:ef7eb2e8f9f7 1186 MODIFY_REG(hsc->Instance->CR2, USART_CR2_MSBFIRST, hsc->AdvancedInit.MSBFirst);
<> 144:ef7eb2e8f9f7 1187 }
<> 144:ef7eb2e8f9f7 1188 }
<> 144:ef7eb2e8f9f7 1189
<> 144:ef7eb2e8f9f7 1190 /**
<> 144:ef7eb2e8f9f7 1191 * @brief This function handles SMARTCARD Communication Timeout.
<> 144:ef7eb2e8f9f7 1192 * @param hsc SMARTCARD handle
<> 144:ef7eb2e8f9f7 1193 * @param Flag specifies the SMARTCARD flag to check.
<> 144:ef7eb2e8f9f7 1194 * @param Status The new Flag status (SET or RESET).
<> 144:ef7eb2e8f9f7 1195 * @param Tickstart Tick start value
<> 144:ef7eb2e8f9f7 1196 * @param Timeout Timeout duration
<> 144:ef7eb2e8f9f7 1197 * @retval HAL status
<> 144:ef7eb2e8f9f7 1198 */
<> 144:ef7eb2e8f9f7 1199 static HAL_StatusTypeDef SMARTCARD_WaitOnFlagUntilTimeout(SMARTCARD_HandleTypeDef *hsc, uint32_t Flag, FlagStatus Status, uint32_t Tickstart, uint32_t Timeout)
<> 144:ef7eb2e8f9f7 1200 {
<> 144:ef7eb2e8f9f7 1201 /* Wait until flag is set */
<> 144:ef7eb2e8f9f7 1202 while((__HAL_SMARTCARD_GET_FLAG(hsc, Flag) ? SET : RESET) == Status)
<> 144:ef7eb2e8f9f7 1203 {
<> 144:ef7eb2e8f9f7 1204 /* Check for the Timeout */
<> 144:ef7eb2e8f9f7 1205 if(Timeout != HAL_MAX_DELAY)
<> 144:ef7eb2e8f9f7 1206 {
<> 144:ef7eb2e8f9f7 1207 if((Timeout == 0U)||((HAL_GetTick() - Tickstart ) > Timeout))
<> 144:ef7eb2e8f9f7 1208 {
<> 144:ef7eb2e8f9f7 1209 /* Disable TXE, RXNE, PE and ERR (Frame error, noise error, overrun error) interrupts for the interrupt process */
<> 144:ef7eb2e8f9f7 1210 CLEAR_BIT(hsc->Instance->CR1, USART_CR1_TXEIE);
<> 144:ef7eb2e8f9f7 1211 CLEAR_BIT(hsc->Instance->CR1, USART_CR1_RXNEIE);
<> 144:ef7eb2e8f9f7 1212 __HAL_SMARTCARD_DISABLE_IT(hsc, SMARTCARD_IT_PE);
<> 144:ef7eb2e8f9f7 1213 __HAL_SMARTCARD_DISABLE_IT(hsc, SMARTCARD_IT_ERR);
<> 144:ef7eb2e8f9f7 1214 CLEAR_BIT(hsc->Instance->CR1, USART_CR1_PEIE);
<> 144:ef7eb2e8f9f7 1215 CLEAR_BIT(hsc->Instance->CR3, USART_CR3_EIE);
<> 144:ef7eb2e8f9f7 1216
<> 144:ef7eb2e8f9f7 1217 hsc->gState= HAL_SMARTCARD_STATE_READY;
<> 144:ef7eb2e8f9f7 1218 hsc->RxState= HAL_SMARTCARD_STATE_READY;
<> 144:ef7eb2e8f9f7 1219
<> 144:ef7eb2e8f9f7 1220 /* Process Unlocked */
<> 144:ef7eb2e8f9f7 1221 __HAL_UNLOCK(hsc);
<> 144:ef7eb2e8f9f7 1222
<> 144:ef7eb2e8f9f7 1223 return HAL_TIMEOUT;
<> 144:ef7eb2e8f9f7 1224 }
<> 144:ef7eb2e8f9f7 1225 }
<> 144:ef7eb2e8f9f7 1226 }
<> 144:ef7eb2e8f9f7 1227 return HAL_OK;
<> 144:ef7eb2e8f9f7 1228 }
<> 144:ef7eb2e8f9f7 1229
<> 144:ef7eb2e8f9f7 1230 /*
<> 144:ef7eb2e8f9f7 1231 * @brief End ongoing Tx transfer on SMARTCARD peripheral (following error detection or Transmit completion).
<> 144:ef7eb2e8f9f7 1232 * @param hsc: SMARTCARD handle.
<> 144:ef7eb2e8f9f7 1233 * @retval None
<> 144:ef7eb2e8f9f7 1234 */
<> 144:ef7eb2e8f9f7 1235 static void SMARTCARD_EndTxTransfer(SMARTCARD_HandleTypeDef *hsc)
<> 144:ef7eb2e8f9f7 1236 {
<> 144:ef7eb2e8f9f7 1237 /* Disable TXEIE and TCIE interrupts */
<> 144:ef7eb2e8f9f7 1238 CLEAR_BIT(hsc->Instance->CR1, (USART_CR1_TXEIE | USART_CR1_TCIE));
<> 144:ef7eb2e8f9f7 1239
<> 144:ef7eb2e8f9f7 1240 /* At end of Tx process, restore hsc->gState to Ready */
<> 144:ef7eb2e8f9f7 1241 hsc->gState = HAL_SMARTCARD_STATE_READY;
<> 144:ef7eb2e8f9f7 1242 }
<> 144:ef7eb2e8f9f7 1243
<> 144:ef7eb2e8f9f7 1244
<> 144:ef7eb2e8f9f7 1245 /**
<> 144:ef7eb2e8f9f7 1246 * @brief End ongoing Rx transfer on SMARTCARD peripheral (following error detection or Reception completion).
<> 144:ef7eb2e8f9f7 1247 * @param hsc: SMARTCARD handle.
<> 144:ef7eb2e8f9f7 1248 * @retval None
<> 144:ef7eb2e8f9f7 1249 */
<> 144:ef7eb2e8f9f7 1250 static void SMARTCARD_EndRxTransfer(SMARTCARD_HandleTypeDef *hsc)
<> 144:ef7eb2e8f9f7 1251 {
<> 144:ef7eb2e8f9f7 1252 /* Disable RXNE, PE and ERR (Frame error, noise error, overrun error) interrupts */
<> 144:ef7eb2e8f9f7 1253 CLEAR_BIT(hsc->Instance->CR1, (USART_CR1_RXNEIE | USART_CR1_PEIE));
<> 144:ef7eb2e8f9f7 1254 CLEAR_BIT(hsc->Instance->CR3, USART_CR3_EIE);
<> 144:ef7eb2e8f9f7 1255
<> 144:ef7eb2e8f9f7 1256 /* At end of Rx process, restore hsc->RxState to Ready */
<> 144:ef7eb2e8f9f7 1257 hsc->RxState = HAL_SMARTCARD_STATE_READY;
<> 144:ef7eb2e8f9f7 1258 }
<> 144:ef7eb2e8f9f7 1259
<> 144:ef7eb2e8f9f7 1260 /**
<> 144:ef7eb2e8f9f7 1261 * @brief DMA SMARTCARD transmit process complete callback
<> 144:ef7eb2e8f9f7 1262 * @param hdma: DMA handle
<> 144:ef7eb2e8f9f7 1263 * @retval None
<> 144:ef7eb2e8f9f7 1264 */
<> 144:ef7eb2e8f9f7 1265 static void SMARTCARD_DMATransmitCplt(DMA_HandleTypeDef *hdma)
<> 144:ef7eb2e8f9f7 1266 {
<> 144:ef7eb2e8f9f7 1267 SMARTCARD_HandleTypeDef* hsc = ( SMARTCARD_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
<> 144:ef7eb2e8f9f7 1268 hsc->TxXferCount = 0;
<> 144:ef7eb2e8f9f7 1269
<> 144:ef7eb2e8f9f7 1270 /* Disable the DMA transfer for transmit request by setting the DMAT bit
<> 144:ef7eb2e8f9f7 1271 in the USART CR3 register */
<> 144:ef7eb2e8f9f7 1272 CLEAR_BIT(hsc->Instance->CR3, USART_CR3_DMAT);
<> 144:ef7eb2e8f9f7 1273
<> 144:ef7eb2e8f9f7 1274 /* Enable the SMARTCARD Transmit Complete Interrupt */
<> 144:ef7eb2e8f9f7 1275 SET_BIT(hsc->Instance->CR1, USART_CR1_TCIE);
<> 144:ef7eb2e8f9f7 1276 }
<> 144:ef7eb2e8f9f7 1277
<> 144:ef7eb2e8f9f7 1278 /**
<> 144:ef7eb2e8f9f7 1279 * @brief DMA SMARTCARD receive process complete callback
<> 144:ef7eb2e8f9f7 1280 * @param hdma: DMA handle
<> 144:ef7eb2e8f9f7 1281 * @retval None
<> 144:ef7eb2e8f9f7 1282 */
<> 144:ef7eb2e8f9f7 1283 static void SMARTCARD_DMAReceiveCplt(DMA_HandleTypeDef *hdma)
<> 144:ef7eb2e8f9f7 1284 {
<> 144:ef7eb2e8f9f7 1285 SMARTCARD_HandleTypeDef* hsc = ( SMARTCARD_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
<> 144:ef7eb2e8f9f7 1286 hsc->RxXferCount = 0;
<> 144:ef7eb2e8f9f7 1287
<> 144:ef7eb2e8f9f7 1288 /* Disable RXNE, PE and ERR (Frame error, noise error, overrun error) interrupts */
<> 144:ef7eb2e8f9f7 1289 CLEAR_BIT(hsc->Instance->CR1, (USART_CR1_RXNEIE | USART_CR1_PEIE));
<> 144:ef7eb2e8f9f7 1290 CLEAR_BIT(hsc->Instance->CR3, USART_CR3_EIE);
<> 144:ef7eb2e8f9f7 1291
<> 144:ef7eb2e8f9f7 1292 /* Disable the DMA transfer for the receiver request by setting the DMAR bit
<> 144:ef7eb2e8f9f7 1293 in the SMARTCARD associated USART CR3 register */
<> 144:ef7eb2e8f9f7 1294 CLEAR_BIT(hsc->Instance->CR3, USART_CR3_DMAR);
<> 144:ef7eb2e8f9f7 1295
<> 144:ef7eb2e8f9f7 1296 /* At end of Rx process, restore hsc->RxState to Ready */
<> 144:ef7eb2e8f9f7 1297 hsc->RxState = HAL_SMARTCARD_STATE_READY;
<> 144:ef7eb2e8f9f7 1298
<> 144:ef7eb2e8f9f7 1299 HAL_SMARTCARD_RxCpltCallback(hsc);
<> 144:ef7eb2e8f9f7 1300 }
<> 144:ef7eb2e8f9f7 1301
<> 144:ef7eb2e8f9f7 1302 /**
<> 144:ef7eb2e8f9f7 1303 * @brief DMA SMARTCARD communication error callback
<> 144:ef7eb2e8f9f7 1304 * @param hdma: DMA handle
<> 144:ef7eb2e8f9f7 1305 * @retval None
<> 144:ef7eb2e8f9f7 1306 */
<> 144:ef7eb2e8f9f7 1307 static void SMARTCARD_DMAError(DMA_HandleTypeDef *hdma)
<> 144:ef7eb2e8f9f7 1308 {
<> 144:ef7eb2e8f9f7 1309 SMARTCARD_HandleTypeDef* hsc = ( SMARTCARD_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
<> 144:ef7eb2e8f9f7 1310 hsc->RxXferCount = 0U;
<> 144:ef7eb2e8f9f7 1311 hsc->TxXferCount = 0U;
<> 144:ef7eb2e8f9f7 1312 hsc->ErrorCode = HAL_SMARTCARD_ERROR_DMA;
<> 144:ef7eb2e8f9f7 1313
<> 144:ef7eb2e8f9f7 1314 /* Stop SMARTCARD DMA Tx request if ongoing */
<> 144:ef7eb2e8f9f7 1315 if ( (hsc->gState == HAL_SMARTCARD_STATE_BUSY_TX)
<> 144:ef7eb2e8f9f7 1316 &&(HAL_IS_BIT_SET(hsc->Instance->CR3, USART_CR3_DMAT)) )
<> 144:ef7eb2e8f9f7 1317 {
<> 144:ef7eb2e8f9f7 1318 SMARTCARD_EndTxTransfer(hsc);
<> 144:ef7eb2e8f9f7 1319 }
<> 144:ef7eb2e8f9f7 1320
<> 144:ef7eb2e8f9f7 1321 /* Stop SMARTCARD DMA Rx request if ongoing */
<> 144:ef7eb2e8f9f7 1322 if ( (hsc->RxState == HAL_SMARTCARD_STATE_BUSY_RX)
<> 144:ef7eb2e8f9f7 1323 &&(HAL_IS_BIT_SET(hsc->Instance->CR3, USART_CR3_DMAR)) )
<> 144:ef7eb2e8f9f7 1324 {
<> 144:ef7eb2e8f9f7 1325 SMARTCARD_EndRxTransfer(hsc);
<> 144:ef7eb2e8f9f7 1326 }
<> 144:ef7eb2e8f9f7 1327
<> 144:ef7eb2e8f9f7 1328 HAL_SMARTCARD_ErrorCallback(hsc);
<> 144:ef7eb2e8f9f7 1329 }
<> 144:ef7eb2e8f9f7 1330
<> 144:ef7eb2e8f9f7 1331 /**
<> 144:ef7eb2e8f9f7 1332 * @brief DMA SMARTCARD communication abort callback, when call by HAL services on Error
<> 144:ef7eb2e8f9f7 1333 * (To be called at end of DMA Abort procedure following error occurrence).
<> 144:ef7eb2e8f9f7 1334 * @param hdma: DMA handle.
<> 144:ef7eb2e8f9f7 1335 * @retval None
<> 144:ef7eb2e8f9f7 1336 */
<> 144:ef7eb2e8f9f7 1337 static void SMARTCARD_DMAAbortOnError(DMA_HandleTypeDef *hdma)
<> 144:ef7eb2e8f9f7 1338 {
<> 144:ef7eb2e8f9f7 1339 SMARTCARD_HandleTypeDef* hsc = ( SMARTCARD_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
<> 144:ef7eb2e8f9f7 1340 hsc->RxXferCount = 0U;
<> 144:ef7eb2e8f9f7 1341 hsc->TxXferCount = 0U;
<> 144:ef7eb2e8f9f7 1342
<> 144:ef7eb2e8f9f7 1343 HAL_SMARTCARD_ErrorCallback(hsc);
<> 144:ef7eb2e8f9f7 1344 }
<> 144:ef7eb2e8f9f7 1345
<> 144:ef7eb2e8f9f7 1346 /**
<> 144:ef7eb2e8f9f7 1347 * @}
<> 144:ef7eb2e8f9f7 1348 */
<> 144:ef7eb2e8f9f7 1349
<> 144:ef7eb2e8f9f7 1350 #endif /* HAL_SMARTCARD_MODULE_ENABLED */
<> 144:ef7eb2e8f9f7 1351 /**
<> 144:ef7eb2e8f9f7 1352 * @}
<> 144:ef7eb2e8f9f7 1353 */
<> 144:ef7eb2e8f9f7 1354
<> 144:ef7eb2e8f9f7 1355 /**
<> 144:ef7eb2e8f9f7 1356 * @}
<> 144:ef7eb2e8f9f7 1357 */
<> 144:ef7eb2e8f9f7 1358
<> 144:ef7eb2e8f9f7 1359 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/