Abdessamad El Abbassi / mbed-src-temp

mbed library sources

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_NUCLEO_F401RE/stm32f4xx_hal_smartcard.c@106:ced8cbb51063, 2014-02-26 (annotated)

Committer:
mbed_official
Date:
Wed Feb 26 09:45:12 2014 +0000
Revision:
106:ced8cbb51063
Parent:
87:085cde657901 
Synchronized with git revision 4222735eff5868389433f0e9271976b39c8115cd



Full URL: https://github.com/mbedmicro/mbed/commit/4222735eff5868389433f0e9271976b39c8115cd/



[NUCLEO_xxx] Update STM32CubeF4 driver V1.0.0 + update license

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 87:085cde657901 1 /**
mbed_official 87:085cde657901 2 ******************************************************************************
mbed_official 87:085cde657901 3 * @file stm32f4xx_hal_smartcard.c
mbed_official 87:085cde657901 4 * @author MCD Application Team
mbed_official 106:ced8cbb51063 5 * @version V1.0.0
mbed_official 106:ced8cbb51063 6 * @date 18-February-2014
mbed_official 87:085cde657901 7 * @brief SMARTCARD HAL module driver.
mbed_official 87:085cde657901 8 * This file provides firmware functions to manage the following
mbed_official 87:085cde657901 9 * functionalities of the SMARTCARD peripheral:
mbed_official 87:085cde657901 10 * + Initialization and de-initialization functions
mbed_official 87:085cde657901 11 * + IO operation functions
mbed_official 87:085cde657901 12 * + Peripheral State and Errors functions
mbed_official 87:085cde657901 13 *
mbed_official 87:085cde657901 14 @verbatim
mbed_official 87:085cde657901 15 ==============================================================================
mbed_official 87:085cde657901 16 ##### How to use this driver #####
mbed_official 87:085cde657901 17 ==============================================================================
mbed_official 87:085cde657901 18 [..]
mbed_official 87:085cde657901 19 The SMARTCARD HAL driver can be used as follow:
mbed_official 87:085cde657901 20
mbed_official 87:085cde657901 21 (#) Declare a SMARTCARD_HandleTypeDef handle structure.
mbed_official 87:085cde657901 22 (#) Initialize the SMARTCARD low level resources by implement the HAL_SMARTCARD_MspInit ()API:
mbed_official 87:085cde657901 23 (##) Enable the USARTx interface clock.
mbed_official 87:085cde657901 24 (##) SMARTCARD pins configuration:
mbed_official 87:085cde657901 25 (+++) Enable the clock for the SMARTCARD GPIOs.
mbed_official 87:085cde657901 26 (+++) Configure these SMARTCARD pins as alternate function pull-up.
mbed_official 87:085cde657901 27 (##) NVIC configuration if you need to use interrupt process (HAL_SMARTCARD_Transmit_IT()
mbed_official 87:085cde657901 28 and HAL_SMARTCARD_Receive_IT() APIs):
mbed_official 87:085cde657901 29 (+++) Configure the USARTx interrupt priority.
mbed_official 87:085cde657901 30 (+++) Enable the NVIC USART IRQ handle.
mbed_official 87:085cde657901 31
mbed_official 87:085cde657901 32 -@@- The specific SMARTCARD interrupts (Transmission complete interrupt,
mbed_official 87:085cde657901 33 RXNE interrupt and Error Interrupts) will be managed using the macros
mbed_official 87:085cde657901 34 __SMARTCARD_ENABLE_IT() and __SMARTCARD_DISABLE_IT() inside the transmit and receive process.
mbed_official 87:085cde657901 35 (##) DMA Configuration if you need to use DMA process (HAL_SMARTCARD_Transmit_DMA()
mbed_official 87:085cde657901 36 and HAL_SMARTCARD_Receive_DMA() APIs):
mbed_official 87:085cde657901 37 (+++) Declare a DMA handle structure for the Tx/Rx stream.
mbed_official 87:085cde657901 38 (+++) Enable the DMAx interface clock.
mbed_official 87:085cde657901 39 (+++) Configure the declared DMA handle structure with the required Tx/Rx parameters.
mbed_official 87:085cde657901 40 (+++) Configure the DMA Tx/Rx Stream.
mbed_official 87:085cde657901 41 (+++) Associate the initilalized DMA handle to the SMARTCARD DMA Tx/Rx handle.
mbed_official 87:085cde657901 42 (+++) Configure the priority and enable the NVIC for the transfer complete interrupt on the DMA Tx/Rx Stream.
mbed_official 87:085cde657901 43
mbed_official 87:085cde657901 44 (#) Program the Baud Rate, Word Length , Stop Bit, Parity, Hardware
mbed_official 87:085cde657901 45 flow control and Mode(Receiver/Transmitter) in the hsc Init structure.
mbed_official 87:085cde657901 46
mbed_official 87:085cde657901 47 (#) Initialize the SMARTCARD registers by calling the HAL_SMARTCARD_Init() API:
mbed_official 87:085cde657901 48 (++) These API's configures also the low level Hardware GPIO, CLOCK, CORTEX...etc)
mbed_official 87:085cde657901 49 by calling the customed HAL_SMARTCARD_MspInit(&hsc) API.
mbed_official 87:085cde657901 50
mbed_official 87:085cde657901 51 (#) Three mode of operations are available within this driver :
mbed_official 87:085cde657901 52
mbed_official 87:085cde657901 53 *** Polling mode IO operation ***
mbed_official 87:085cde657901 54 =================================
mbed_official 87:085cde657901 55 [..]
mbed_official 87:085cde657901 56 (+) Send an amount of data in blocking mode using HAL_SMARTCARD_Transmit()
mbed_official 87:085cde657901 57 (+) Receive an amount of data in blocking mode using HAL_SMARTCARD_Receive()
mbed_official 87:085cde657901 58
mbed_official 87:085cde657901 59 *** Interrupt mode IO operation ***
mbed_official 87:085cde657901 60 ===================================
mbed_official 87:085cde657901 61 [..]
mbed_official 87:085cde657901 62 (+) Send an amount of data in non blocking mode using HAL_SMARTCARD_Transmit_IT()
mbed_official 87:085cde657901 63 (+) At transmission end of transfer HAL_SMARTCARD_TxCpltCallback is executed and user can
mbed_official 87:085cde657901 64 add his own code by customization of function pointer HAL_SMARTCARD_TxCpltCallback
mbed_official 87:085cde657901 65 (+) Receive an amount of data in non blocking mode using HAL_SMARTCARD_Receive_IT()
mbed_official 87:085cde657901 66 (+) At reception end of transfer HAL_SMARTCARD_RxCpltCallback is executed and user can
mbed_official 106:ced8cbb51063 67 add his own code by customization of function pointer HAL_SMARTCARD_RxCpltCallback
mbed_official 87:085cde657901 68 (+) In case of transfer Error, HAL_SMARTCARD_ErrorCallback() function is executed and user can
mbed_official 87:085cde657901 69 add his own code by customization of function pointer HAL_SMARTCARD_ErrorCallback
mbed_official 87:085cde657901 70
mbed_official 87:085cde657901 71 *** DMA mode IO operation ***
mbed_official 87:085cde657901 72 ==============================
mbed_official 87:085cde657901 73 [..]
mbed_official 87:085cde657901 74 (+) Send an amount of data in non blocking mode (DMA) using HAL_SMARTCARD_Transmit_DMA()
mbed_official 87:085cde657901 75 (+) At transmission end of transfer HAL_SMARTCARD_TxCpltCallback is executed and user can
mbed_official 87:085cde657901 76 add his own code by customization of function pointer HAL_SMARTCARD_TxCpltCallback
mbed_official 87:085cde657901 77 (+) Receive an amount of data in non blocking mode (DMA) using HAL_SMARTCARD_Receive_DMA()
mbed_official 87:085cde657901 78 (+) At reception end of transfer HAL_SMARTCARD_RxCpltCallback is executed and user can
mbed_official 106:ced8cbb51063 79 add his own code by customization of function pointer HAL_SMARTCARD_RxCpltCallback
mbed_official 87:085cde657901 80 (+) In case of transfer Error, HAL_SMARTCARD_ErrorCallback() function is executed and user can
mbed_official 87:085cde657901 81 add his own code by customization of function pointer HAL_SMARTCARD_ErrorCallback
mbed_official 87:085cde657901 82
mbed_official 87:085cde657901 83 *** SMARTCARD HAL driver macros list ***
mbed_official 87:085cde657901 84 =============================================
mbed_official 87:085cde657901 85 [..]
mbed_official 87:085cde657901 86 Below the list of most used macros in SMARTCARD HAL driver.
mbed_official 87:085cde657901 87
mbed_official 87:085cde657901 88 (+) __HAL_SMARTCARD_ENABLE: Enable the SMARTCARD peripheral
mbed_official 87:085cde657901 89 (+) __HAL_SMARTCARD_DISABLE: Disable the SMARTCARD peripheral
mbed_official 87:085cde657901 90 (+) __HAL_SMARTCARD_GET_FLAG : Checks whether the specified SMARTCARD flag is set or not
mbed_official 87:085cde657901 91 (+) __HAL_SMARTCARD_CLEAR_FLAG : Clears the specified SMARTCARD pending flag
mbed_official 87:085cde657901 92 (+) __HAL_SMARTCARD_ENABLE_IT: Enables the specified SMARTCARD interrupt
mbed_official 87:085cde657901 93 (+) __HAL_SMARTCARD_DISABLE_IT: Disables the specified SMARTCARD interrupt
mbed_official 87:085cde657901 94
mbed_official 87:085cde657901 95 [..]
mbed_official 87:085cde657901 96 (@) You can refer to the SMARTCARD HAL driver header file for more useful macros
mbed_official 87:085cde657901 97
mbed_official 87:085cde657901 98 @endverbatim
mbed_official 87:085cde657901 99 ******************************************************************************
mbed_official 87:085cde657901 100 * @attention
mbed_official 87:085cde657901 101 *
mbed_official 87:085cde657901 102 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
mbed_official 87:085cde657901 103 *
mbed_official 87:085cde657901 104 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 87:085cde657901 105 * are permitted provided that the following conditions are met:
mbed_official 87:085cde657901 106 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 87:085cde657901 107 * this list of conditions and the following disclaimer.
mbed_official 87:085cde657901 108 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 87:085cde657901 109 * this list of conditions and the following disclaimer in the documentation
mbed_official 87:085cde657901 110 * and/or other materials provided with the distribution.
mbed_official 87:085cde657901 111 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 87:085cde657901 112 * may be used to endorse or promote products derived from this software
mbed_official 87:085cde657901 113 * without specific prior written permission.
mbed_official 87:085cde657901 114 *
mbed_official 87:085cde657901 115 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 87:085cde657901 116 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 87:085cde657901 117 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 87:085cde657901 118 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 87:085cde657901 119 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 87:085cde657901 120 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 87:085cde657901 121 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 87:085cde657901 122 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 87:085cde657901 123 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 87:085cde657901 124 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 87:085cde657901 125 *
mbed_official 87:085cde657901 126 ******************************************************************************
mbed_official 87:085cde657901 127 */
mbed_official 87:085cde657901 128
mbed_official 87:085cde657901 129 /* Includes ------------------------------------------------------------------*/
mbed_official 87:085cde657901 130 #include "stm32f4xx_hal.h"
mbed_official 87:085cde657901 131
mbed_official 87:085cde657901 132 /** @addtogroup STM32F4xx_HAL_Driver
mbed_official 87:085cde657901 133 * @{
mbed_official 87:085cde657901 134 */
mbed_official 87:085cde657901 135
mbed_official 87:085cde657901 136 /** @defgroup SMARTCARD
mbed_official 87:085cde657901 137 * @brief HAL USART SMARTCARD module driver
mbed_official 87:085cde657901 138 * @{
mbed_official 87:085cde657901 139 */
mbed_official 87:085cde657901 140 #ifdef HAL_SMARTCARD_MODULE_ENABLED
mbed_official 87:085cde657901 141 /* Private typedef -----------------------------------------------------------*/
mbed_official 87:085cde657901 142 /* Private define ------------------------------------------------------------*/
mbed_official 106:ced8cbb51063 143 #define SMARTCARD_TIMEOUT_VALUE 22000
mbed_official 87:085cde657901 144 /* Private macro -------------------------------------------------------------*/
mbed_official 87:085cde657901 145 /* Private variables ---------------------------------------------------------*/
mbed_official 87:085cde657901 146 /* Private function prototypes -----------------------------------------------*/
mbed_official 87:085cde657901 147 static void SMARTCARD_SetConfig (SMARTCARD_HandleTypeDef *hsc);
mbed_official 87:085cde657901 148 static HAL_StatusTypeDef SMARTCARD_Transmit_IT(SMARTCARD_HandleTypeDef *hsc);
mbed_official 87:085cde657901 149 static HAL_StatusTypeDef SMARTCARD_Receive_IT(SMARTCARD_HandleTypeDef *hsc);
mbed_official 87:085cde657901 150 static void SMARTCARD_DMATransmitCplt(DMA_HandleTypeDef *hdma);
mbed_official 87:085cde657901 151 static void SMARTCARD_DMAReceiveCplt(DMA_HandleTypeDef *hdma);
mbed_official 87:085cde657901 152 static void SMARTCARD_DMAError(DMA_HandleTypeDef *hdma);
mbed_official 87:085cde657901 153 static HAL_StatusTypeDef SMARTCARD_WaitOnFlagUntilTimeout(SMARTCARD_HandleTypeDef *hsc, uint32_t Flag, FlagStatus Status, uint32_t Timeout);
mbed_official 87:085cde657901 154 /* Private functions ---------------------------------------------------------*/
mbed_official 87:085cde657901 155
mbed_official 87:085cde657901 156 /** @defgroup SMARTCARD_Private_Functions
mbed_official 87:085cde657901 157 * @{
mbed_official 87:085cde657901 158 */
mbed_official 87:085cde657901 159
mbed_official 87:085cde657901 160 /** @defgroup SMARTCARD_Group1 SmartCard Initialization and de-initialization functions
mbed_official 87:085cde657901 161 * @brief Initialization and Configuration functions
mbed_official 87:085cde657901 162 *
mbed_official 87:085cde657901 163 @verbatim
mbed_official 87:085cde657901 164 ===============================================================================
mbed_official 87:085cde657901 165 ##### Initialization and Configuration functions #####
mbed_official 87:085cde657901 166 ===============================================================================
mbed_official 87:085cde657901 167 [..]
mbed_official 87:085cde657901 168 This subsection provides a set of functions allowing to initialize the USART
mbed_official 87:085cde657901 169 in Smartcard mode.
mbed_official 87:085cde657901 170 [..]
mbed_official 87:085cde657901 171 The Smartcard interface is designed to support asynchronous protocol Smartcards as
mbed_official 87:085cde657901 172 defined in the ISO 7816-3 standard.
mbed_official 87:085cde657901 173 [..]
mbed_official 87:085cde657901 174 The USART can provide a clock to the smartcard through the SCLK output.
mbed_official 87:085cde657901 175 In smartcard mode, SCLK is not associated to the communication but is simply derived
mbed_official 87:085cde657901 176 from the internal peripheral input clock through a 5-bit prescaler.
mbed_official 87:085cde657901 177 [..]
mbed_official 87:085cde657901 178 (+) For the asynchronous mode only these parameters can be configured:
mbed_official 87:085cde657901 179 (++) Baud Rate
mbed_official 87:085cde657901 180 (++) Word Length
mbed_official 87:085cde657901 181 (++) Stop Bit
mbed_official 87:085cde657901 182 (++) Parity: If the parity is enabled, then the MSB bit of the data written
mbed_official 87:085cde657901 183 in the data register is transmitted but is changed by the parity bit.
mbed_official 87:085cde657901 184 Depending on the frame length defined by the M bit (8-bits or 9-bits),
mbed_official 87:085cde657901 185 the possible SmartCard frame formats are as listed in the following table:
mbed_official 87:085cde657901 186 +-------------------------------------------------------------+
mbed_official 87:085cde657901 187 | M bit | PCE bit | USART frame |
mbed_official 87:085cde657901 188 |---------------------|---------------------------------------|
mbed_official 87:085cde657901 189 | 0 | 0 | | SB | 8 bit data | STB | |
mbed_official 87:085cde657901 190 |---------|-----------|---------------------------------------|
mbed_official 87:085cde657901 191 | 0 | 1 | | SB | 7 bit data | PB | STB | |
mbed_official 87:085cde657901 192 |---------|-----------|---------------------------------------|
mbed_official 87:085cde657901 193 | 1 | 0 | | SB | 9 bit data | STB | |
mbed_official 87:085cde657901 194 |---------|-----------|---------------------------------------|
mbed_official 87:085cde657901 195 | 1 | 1 | | SB | 8 bit data | PB | STB | |
mbed_official 87:085cde657901 196 +-------------------------------------------------------------+
mbed_official 87:085cde657901 197 (++) USART polarity
mbed_official 87:085cde657901 198 (++) USART phase
mbed_official 87:085cde657901 199 (++) USART LastBit
mbed_official 87:085cde657901 200 (++) Receiver/transmitter modes
mbed_official 87:085cde657901 201 (++) Prescaler
mbed_official 87:085cde657901 202 (++) GuardTime
mbed_official 87:085cde657901 203 (++) NACKState: The Smartcard NACK state
mbed_official 87:085cde657901 204
mbed_official 87:085cde657901 205 (+) Recommended SmartCard interface configuration to get the Answer to Reset from the Card:
mbed_official 87:085cde657901 206 (++) Word Length = 9 Bits
mbed_official 87:085cde657901 207 (++) 1.5 Stop Bit
mbed_official 87:085cde657901 208 (++) Even parity
mbed_official 87:085cde657901 209 (++) BaudRate = 12096 baud
mbed_official 87:085cde657901 210 (++) Tx and Rx enabled
mbed_official 87:085cde657901 211 [..]
mbed_official 87:085cde657901 212 Please refer to the ISO 7816-3 specification for more details.
mbed_official 87:085cde657901 213
mbed_official 87:085cde657901 214 -@- It is also possible to choose 0.5 stop bit for receiving but it is recommended
mbed_official 87:085cde657901 215 to use 1.5 stop bits for both transmitting and receiving to avoid switching
mbed_official 87:085cde657901 216 between the two configurations.
mbed_official 87:085cde657901 217 [..]
mbed_official 87:085cde657901 218 The HAL_SMARTCARD_Init() function follows the USART SmartCard configuration
mbed_official 87:085cde657901 219 procedure (details for the procedure are available in reference manual (RM0329)).
mbed_official 87:085cde657901 220
mbed_official 87:085cde657901 221 @endverbatim
mbed_official 87:085cde657901 222 * @{
mbed_official 87:085cde657901 223 */
mbed_official 87:085cde657901 224
mbed_official 87:085cde657901 225 /**
mbed_official 87:085cde657901 226 * @brief Initializes the SmartCard mode according to the specified
mbed_official 87:085cde657901 227 * parameters in the SMARTCARD_InitTypeDef and create the associated handle .
mbed_official 87:085cde657901 228 * @param hsc: usart handle
mbed_official 87:085cde657901 229 * @retval HAL status
mbed_official 87:085cde657901 230 */
mbed_official 87:085cde657901 231 HAL_StatusTypeDef HAL_SMARTCARD_Init(SMARTCARD_HandleTypeDef *hsc)
mbed_official 87:085cde657901 232 {
mbed_official 87:085cde657901 233 /* Check the SMARTCARD handle allocation */
mbed_official 87:085cde657901 234 if(hsc == NULL)
mbed_official 87:085cde657901 235 {
mbed_official 87:085cde657901 236 return HAL_ERROR;
mbed_official 87:085cde657901 237 }
mbed_official 87:085cde657901 238
mbed_official 87:085cde657901 239 /* Check the parameters */
mbed_official 87:085cde657901 240 assert_param(IS_SMARTCARD_INSTANCE(hsc->Instance));
mbed_official 87:085cde657901 241 assert_param(IS_SMARTCARD_NACK_STATE(hsc->Init.NACKState));
mbed_official 87:085cde657901 242
mbed_official 87:085cde657901 243 if(hsc->State == HAL_SMARTCARD_STATE_RESET)
mbed_official 87:085cde657901 244 {
mbed_official 87:085cde657901 245 /* Init the low level hardware : GPIO, CLOCK, CORTEX...etc */
mbed_official 87:085cde657901 246 HAL_SMARTCARD_MspInit(hsc);
mbed_official 87:085cde657901 247 }
mbed_official 87:085cde657901 248
mbed_official 87:085cde657901 249 hsc->State = HAL_SMARTCARD_STATE_BUSY;
mbed_official 87:085cde657901 250
mbed_official 87:085cde657901 251 /* Set the Prescaler */
mbed_official 87:085cde657901 252 MODIFY_REG(hsc->Instance->GTPR, USART_GTPR_PSC, hsc->Init.Prescaler);
mbed_official 87:085cde657901 253
mbed_official 87:085cde657901 254 /* Set the Guard Time */
mbed_official 87:085cde657901 255 MODIFY_REG(hsc->Instance->GTPR, USART_GTPR_GT, ((hsc->Init.GuardTime)<<8));
mbed_official 87:085cde657901 256
mbed_official 87:085cde657901 257 /* Set the Smartcard Communication parameters */
mbed_official 87:085cde657901 258 SMARTCARD_SetConfig(hsc);
mbed_official 87:085cde657901 259
mbed_official 87:085cde657901 260 /* In SmartCard mode, the following bits must be kept cleared:
mbed_official 87:085cde657901 261 - LINEN bit in the USART_CR2 register
mbed_official 87:085cde657901 262 - HDSEL and IREN bits in the USART_CR3 register.*/
mbed_official 87:085cde657901 263 hsc->Instance->CR2 &= ~USART_CR2_LINEN;
mbed_official 87:085cde657901 264 hsc->Instance->CR3 &= ~(USART_CR3_IREN | USART_CR3_HDSEL);
mbed_official 87:085cde657901 265
mbed_official 87:085cde657901 266 /* Enable the SMARTCARD Parity Error Interrupt */
mbed_official 87:085cde657901 267 __SMARTCARD_ENABLE_IT(hsc, SMARTCARD_IT_PE);
mbed_official 87:085cde657901 268
mbed_official 87:085cde657901 269 /* Enable the SMARTCARD Framing Error Interrupt */
mbed_official 87:085cde657901 270 __SMARTCARD_ENABLE_IT(hsc, SMARTCARD_IT_ERR);
mbed_official 87:085cde657901 271
mbed_official 87:085cde657901 272 /* Enable the Peripharal */
mbed_official 87:085cde657901 273 __SMARTCARD_ENABLE(hsc);
mbed_official 87:085cde657901 274
mbed_official 87:085cde657901 275 /* Configure the Smartcard NACK state */
mbed_official 87:085cde657901 276 MODIFY_REG(hsc->Instance->CR3, USART_CR3_NACK, hsc->Init.NACKState);
mbed_official 87:085cde657901 277
mbed_official 87:085cde657901 278 /* Enable the SC mode by setting the SCEN bit in the CR3 register */
mbed_official 87:085cde657901 279 hsc->Instance->CR3 |= (USART_CR3_SCEN);
mbed_official 87:085cde657901 280
mbed_official 87:085cde657901 281 /* Initialize the SMARTCARD state*/
mbed_official 87:085cde657901 282 hsc->ErrorCode = HAL_SMARTCARD_ERROR_NONE;
mbed_official 87:085cde657901 283 hsc->State= HAL_SMARTCARD_STATE_READY;
mbed_official 87:085cde657901 284
mbed_official 87:085cde657901 285 return HAL_OK;
mbed_official 87:085cde657901 286 }
mbed_official 87:085cde657901 287
mbed_official 87:085cde657901 288 /**
mbed_official 87:085cde657901 289 * @brief DeInitializes the USART SmartCard peripheral
mbed_official 87:085cde657901 290 * @param hsc: usart handle
mbed_official 87:085cde657901 291 * @retval HAL status
mbed_official 87:085cde657901 292 */
mbed_official 87:085cde657901 293 HAL_StatusTypeDef HAL_SMARTCARD_DeInit(SMARTCARD_HandleTypeDef *hsc)
mbed_official 87:085cde657901 294 {
mbed_official 106:ced8cbb51063 295 /* Check the SMARTCARD handle allocation */
mbed_official 87:085cde657901 296 if(hsc == NULL)
mbed_official 87:085cde657901 297 {
mbed_official 87:085cde657901 298 return HAL_ERROR;
mbed_official 87:085cde657901 299 }
mbed_official 87:085cde657901 300
mbed_official 87:085cde657901 301 /* Check the parameters */
mbed_official 87:085cde657901 302 assert_param(IS_SMARTCARD_INSTANCE(hsc->Instance));
mbed_official 87:085cde657901 303
mbed_official 87:085cde657901 304 hsc->State = HAL_SMARTCARD_STATE_BUSY;
mbed_official 87:085cde657901 305
mbed_official 87:085cde657901 306 /* DeInit the low level hardware */
mbed_official 87:085cde657901 307 HAL_SMARTCARD_MspDeInit(hsc);
mbed_official 87:085cde657901 308
mbed_official 87:085cde657901 309 hsc->ErrorCode = HAL_SMARTCARD_ERROR_NONE;
mbed_official 87:085cde657901 310 hsc->State = HAL_SMARTCARD_STATE_RESET;
mbed_official 87:085cde657901 311
mbed_official 106:ced8cbb51063 312 /* Release Lock */
mbed_official 106:ced8cbb51063 313 __HAL_UNLOCK(hsc);
mbed_official 106:ced8cbb51063 314
mbed_official 87:085cde657901 315 return HAL_OK;
mbed_official 87:085cde657901 316 }
mbed_official 87:085cde657901 317
mbed_official 87:085cde657901 318 /**
mbed_official 87:085cde657901 319 * @brief SMARTCARD MSP Init
mbed_official 87:085cde657901 320 * @param hsc: usart handle
mbed_official 87:085cde657901 321 * @retval None
mbed_official 87:085cde657901 322 */
mbed_official 87:085cde657901 323 __weak void HAL_SMARTCARD_MspInit(SMARTCARD_HandleTypeDef *hsc)
mbed_official 87:085cde657901 324 {
mbed_official 87:085cde657901 325 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 326 the HAL_SMARTCARD_MspInit could be implenetd in the user file
mbed_official 87:085cde657901 327 */
mbed_official 87:085cde657901 328 }
mbed_official 87:085cde657901 329
mbed_official 87:085cde657901 330 /**
mbed_official 87:085cde657901 331 * @brief SMARTCARD MSP DeInit
mbed_official 87:085cde657901 332 * @param hsc: usart handle
mbed_official 87:085cde657901 333 * @retval None
mbed_official 87:085cde657901 334 */
mbed_official 87:085cde657901 335 __weak void HAL_SMARTCARD_MspDeInit(SMARTCARD_HandleTypeDef *hsc)
mbed_official 87:085cde657901 336 {
mbed_official 87:085cde657901 337 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 338 the HAL_SMARTCARD_MspDeInit could be implenetd in the user file
mbed_official 87:085cde657901 339 */
mbed_official 87:085cde657901 340 }
mbed_official 87:085cde657901 341
mbed_official 87:085cde657901 342 /**
mbed_official 87:085cde657901 343 * @}
mbed_official 87:085cde657901 344 */
mbed_official 87:085cde657901 345
mbed_official 87:085cde657901 346 /** @defgroup SMARTCARD_Group2 IO operation functions
mbed_official 87:085cde657901 347 * @brief SMARTCARD Transmit and Receive functions
mbed_official 87:085cde657901 348 *
mbed_official 87:085cde657901 349 @verbatim
mbed_official 87:085cde657901 350 ===============================================================================
mbed_official 87:085cde657901 351 ##### IO operation functions #####
mbed_official 87:085cde657901 352 ===============================================================================
mbed_official 87:085cde657901 353 This subsection provides a set of functions allowing to manage the SMARTCARD data transfers.
mbed_official 87:085cde657901 354 [..]
mbed_official 87:085cde657901 355 IrDA is a half duplex communication protocol. If the Transmitter is busy, any data
mbed_official 87:085cde657901 356 on the IrDA receive line will be ignored by the IrDA decoder and if the Receiver
mbed_official 87:085cde657901 357 is busy, data on the TX from the USART to IrDA will not be encoded by IrDA.
mbed_official 87:085cde657901 358 While receiving data, transmission should be avoided as the data to be transmitted
mbed_official 87:085cde657901 359 could be corrupted.
mbed_official 87:085cde657901 360
mbed_official 87:085cde657901 361 (#) There are two mode of transfer:
mbed_official 87:085cde657901 362 (++) Blocking mode: The communication is performed in polling mode.
mbed_official 87:085cde657901 363 The HAL status of all data processing is returned by the same function
mbed_official 87:085cde657901 364 after finishing transfer.
mbed_official 87:085cde657901 365 (++) No-Blocking mode: The communication is performed using Interrupts
mbed_official 87:085cde657901 366 or DMA, These API's return the HAL status.
mbed_official 87:085cde657901 367 The end of the data processing will be indicated through the
mbed_official 87:085cde657901 368 dedicated SMARTCARD IRQ when using Interrupt mode or the DMA IRQ when
mbed_official 87:085cde657901 369 using DMA mode.
mbed_official 87:085cde657901 370 The HAL_SMARTCARD_TxCpltCallback(), HAL_SMARTCARD_RxCpltCallback() user callbacks
mbed_official 87:085cde657901 371 will be executed respectivelly at the end of the transmit or Receive process
mbed_official 87:085cde657901 372 The HAL_SMARTCARD_ErrorCallback()user callback will be executed when a communication error is detected
mbed_official 87:085cde657901 373
mbed_official 87:085cde657901 374 (#) Blocking mode API's are :
mbed_official 87:085cde657901 375 (++) HAL_SMARTCARD_Transmit()
mbed_official 87:085cde657901 376 (++) HAL_SMARTCARD_Receive()
mbed_official 87:085cde657901 377
mbed_official 87:085cde657901 378 (#) Non-Blocking mode API's with Interrupt are :
mbed_official 87:085cde657901 379 (++) HAL_SMARTCARD_Transmit_IT()
mbed_official 87:085cde657901 380 (++) HAL_SMARTCARD_Receive_IT()
mbed_official 87:085cde657901 381 (++) HAL_SMARTCARD_IRQHandler()
mbed_official 87:085cde657901 382
mbed_official 87:085cde657901 383 (#) No-Blocking mode functions with DMA are :
mbed_official 87:085cde657901 384 (++) HAL_SMARTCARD_Transmit_DMA()
mbed_official 87:085cde657901 385 (++) HAL_SMARTCARD_Receive_DMA()
mbed_official 87:085cde657901 386
mbed_official 87:085cde657901 387 (#) A set of Transfer Complete Callbacks are provided in No_Blocking mode:
mbed_official 87:085cde657901 388 (++) HAL_SMARTCARD_TxCpltCallback()
mbed_official 87:085cde657901 389 (++) HAL_SMARTCARD_RxCpltCallback()
mbed_official 87:085cde657901 390 (++) HAL_SMARTCARD_ErrorCallback()
mbed_official 87:085cde657901 391
mbed_official 87:085cde657901 392 @endverbatim
mbed_official 87:085cde657901 393 * @{
mbed_official 87:085cde657901 394 */
mbed_official 87:085cde657901 395
mbed_official 87:085cde657901 396 /**
mbed_official 87:085cde657901 397 * @brief Send an amount of data in blocking mode
mbed_official 87:085cde657901 398 * @param hsc: usart handle
mbed_official 87:085cde657901 399 * @param pData: pointer to data buffer
mbed_official 87:085cde657901 400 * @param Size: amount of data to be sent
mbed_official 87:085cde657901 401 * @retval HAL status
mbed_official 87:085cde657901 402 */
mbed_official 87:085cde657901 403 HAL_StatusTypeDef HAL_SMARTCARD_Transmit(SMARTCARD_HandleTypeDef *hsc, uint8_t *pData, uint16_t Size, uint32_t Timeout)
mbed_official 87:085cde657901 404 {
mbed_official 87:085cde657901 405 uint16_t* tmp;
mbed_official 87:085cde657901 406
mbed_official 87:085cde657901 407 if(hsc->State == HAL_SMARTCARD_STATE_READY)
mbed_official 87:085cde657901 408 {
mbed_official 87:085cde657901 409 if((pData == NULL) || (Size == 0))
mbed_official 87:085cde657901 410 {
mbed_official 87:085cde657901 411 return HAL_ERROR;
mbed_official 87:085cde657901 412 }
mbed_official 87:085cde657901 413
mbed_official 87:085cde657901 414 /* Process Locked */
mbed_official 87:085cde657901 415 __HAL_LOCK(hsc);
mbed_official 87:085cde657901 416
mbed_official 87:085cde657901 417 hsc->ErrorCode = HAL_SMARTCARD_ERROR_NONE;
mbed_official 87:085cde657901 418 hsc->State = HAL_SMARTCARD_STATE_BUSY_TX;
mbed_official 87:085cde657901 419
mbed_official 87:085cde657901 420 hsc->TxXferSize = Size;
mbed_official 87:085cde657901 421 hsc->TxXferCount = Size;
mbed_official 87:085cde657901 422 while(hsc->TxXferCount > 0)
mbed_official 87:085cde657901 423 {
mbed_official 87:085cde657901 424 hsc->TxXferCount--;
mbed_official 87:085cde657901 425 if(hsc->Init.WordLength == SMARTCARD_WORDLENGTH_9B)
mbed_official 87:085cde657901 426 {
mbed_official 87:085cde657901 427 if(SMARTCARD_WaitOnFlagUntilTimeout(hsc, SMARTCARD_FLAG_TXE, RESET, Timeout) != HAL_OK)
mbed_official 87:085cde657901 428 {
mbed_official 87:085cde657901 429 return HAL_TIMEOUT;
mbed_official 87:085cde657901 430 }
mbed_official 87:085cde657901 431 tmp = (uint16_t*) pData;
mbed_official 87:085cde657901 432 hsc->Instance->DR = (*tmp & (uint16_t)0x01FF);
mbed_official 87:085cde657901 433 if(hsc->Init.Parity == SMARTCARD_PARITY_NONE)
mbed_official 87:085cde657901 434 {
mbed_official 87:085cde657901 435 pData +=2;
mbed_official 87:085cde657901 436 }
mbed_official 87:085cde657901 437 else
mbed_official 87:085cde657901 438 {
mbed_official 87:085cde657901 439 pData +=1;
mbed_official 87:085cde657901 440 }
mbed_official 87:085cde657901 441 }
mbed_official 87:085cde657901 442 else
mbed_official 87:085cde657901 443 {
mbed_official 87:085cde657901 444 if(SMARTCARD_WaitOnFlagUntilTimeout(hsc, SMARTCARD_FLAG_TXE, RESET, Timeout) != HAL_OK)
mbed_official 87:085cde657901 445 {
mbed_official 87:085cde657901 446 return HAL_TIMEOUT;
mbed_official 87:085cde657901 447 }
mbed_official 87:085cde657901 448 hsc->Instance->DR = (*pData++ & (uint8_t)0xFF);
mbed_official 87:085cde657901 449 }
mbed_official 87:085cde657901 450 }
mbed_official 87:085cde657901 451
mbed_official 87:085cde657901 452 if(SMARTCARD_WaitOnFlagUntilTimeout(hsc, SMARTCARD_FLAG_TC, RESET, Timeout) != HAL_OK)
mbed_official 87:085cde657901 453 {
mbed_official 87:085cde657901 454 return HAL_TIMEOUT;
mbed_official 87:085cde657901 455 }
mbed_official 87:085cde657901 456
mbed_official 87:085cde657901 457 hsc->State = HAL_SMARTCARD_STATE_READY;
mbed_official 87:085cde657901 458
mbed_official 87:085cde657901 459 /* Process Unlocked */
mbed_official 87:085cde657901 460 __HAL_UNLOCK(hsc);
mbed_official 87:085cde657901 461
mbed_official 87:085cde657901 462 return HAL_OK;
mbed_official 87:085cde657901 463 }
mbed_official 87:085cde657901 464 else
mbed_official 87:085cde657901 465 {
mbed_official 87:085cde657901 466 return HAL_BUSY;
mbed_official 87:085cde657901 467 }
mbed_official 87:085cde657901 468 }
mbed_official 87:085cde657901 469
mbed_official 87:085cde657901 470 /**
mbed_official 87:085cde657901 471 * @brief Receive an amount of data in blocking mode
mbed_official 87:085cde657901 472 * @param hsc: usart handle
mbed_official 87:085cde657901 473 * @param pData: pointer to data buffer
mbed_official 87:085cde657901 474 * @param Size: amount of data to be received
mbed_official 87:085cde657901 475 * @retval HAL status
mbed_official 87:085cde657901 476 */
mbed_official 87:085cde657901 477 HAL_StatusTypeDef HAL_SMARTCARD_Receive(SMARTCARD_HandleTypeDef *hsc, uint8_t *pData, uint16_t Size, uint32_t Timeout)
mbed_official 87:085cde657901 478 {
mbed_official 87:085cde657901 479 uint16_t* tmp;
mbed_official 87:085cde657901 480
mbed_official 87:085cde657901 481 if(hsc->State == HAL_SMARTCARD_STATE_READY)
mbed_official 87:085cde657901 482 {
mbed_official 87:085cde657901 483 if((pData == NULL) || (Size == 0))
mbed_official 87:085cde657901 484 {
mbed_official 87:085cde657901 485 return HAL_ERROR;
mbed_official 87:085cde657901 486 }
mbed_official 87:085cde657901 487
mbed_official 87:085cde657901 488 /* Process Locked */
mbed_official 87:085cde657901 489 __HAL_LOCK(hsc);
mbed_official 87:085cde657901 490
mbed_official 87:085cde657901 491 hsc->ErrorCode = HAL_SMARTCARD_ERROR_NONE;
mbed_official 87:085cde657901 492 hsc->State = HAL_SMARTCARD_STATE_BUSY_RX;
mbed_official 87:085cde657901 493
mbed_official 87:085cde657901 494 hsc->RxXferSize = Size;
mbed_official 87:085cde657901 495 hsc->RxXferCount = Size;
mbed_official 87:085cde657901 496 /* Check the remain data to be received */
mbed_official 87:085cde657901 497 while(hsc->RxXferCount > 0)
mbed_official 87:085cde657901 498 {
mbed_official 87:085cde657901 499 hsc->RxXferCount--;
mbed_official 87:085cde657901 500 if(hsc->Init.WordLength == SMARTCARD_WORDLENGTH_9B)
mbed_official 87:085cde657901 501 {
mbed_official 87:085cde657901 502 if(SMARTCARD_WaitOnFlagUntilTimeout(hsc, SMARTCARD_FLAG_RXNE, RESET, Timeout) != HAL_OK)
mbed_official 87:085cde657901 503 {
mbed_official 87:085cde657901 504 return HAL_TIMEOUT;
mbed_official 87:085cde657901 505 }
mbed_official 87:085cde657901 506 tmp = (uint16_t*) pData;
mbed_official 87:085cde657901 507 if(hsc->Init.Parity == SMARTCARD_PARITY_NONE)
mbed_official 87:085cde657901 508 {
mbed_official 87:085cde657901 509 *tmp = (uint16_t)(hsc->Instance->DR & (uint16_t)0x01FF);
mbed_official 87:085cde657901 510 pData +=2;
mbed_official 87:085cde657901 511 }
mbed_official 87:085cde657901 512 else
mbed_official 87:085cde657901 513 {
mbed_official 87:085cde657901 514 *tmp = (uint16_t)(hsc->Instance->DR & (uint16_t)0x00FF);
mbed_official 87:085cde657901 515 pData +=1;
mbed_official 87:085cde657901 516 }
mbed_official 87:085cde657901 517 }
mbed_official 87:085cde657901 518 else
mbed_official 87:085cde657901 519 {
mbed_official 87:085cde657901 520 if(SMARTCARD_WaitOnFlagUntilTimeout(hsc, SMARTCARD_FLAG_RXNE, RESET, Timeout) != HAL_OK)
mbed_official 87:085cde657901 521 {
mbed_official 87:085cde657901 522 return HAL_TIMEOUT;
mbed_official 87:085cde657901 523 }
mbed_official 87:085cde657901 524 if(hsc->Init.Parity == SMARTCARD_PARITY_NONE)
mbed_official 87:085cde657901 525 {
mbed_official 87:085cde657901 526 *pData++ = (uint8_t)(hsc->Instance->DR & (uint8_t)0x00FF);
mbed_official 87:085cde657901 527 }
mbed_official 87:085cde657901 528 else
mbed_official 87:085cde657901 529 {
mbed_official 87:085cde657901 530 *pData++ = (uint8_t)(hsc->Instance->DR & (uint8_t)0x007F);
mbed_official 87:085cde657901 531 }
mbed_official 87:085cde657901 532 }
mbed_official 87:085cde657901 533 }
mbed_official 87:085cde657901 534 hsc->State = HAL_SMARTCARD_STATE_READY;
mbed_official 87:085cde657901 535
mbed_official 87:085cde657901 536 /* Process Unlocked */
mbed_official 87:085cde657901 537 __HAL_UNLOCK(hsc);
mbed_official 87:085cde657901 538
mbed_official 87:085cde657901 539 return HAL_OK;
mbed_official 87:085cde657901 540 }
mbed_official 87:085cde657901 541 else
mbed_official 87:085cde657901 542 {
mbed_official 87:085cde657901 543 return HAL_BUSY;
mbed_official 87:085cde657901 544 }
mbed_official 87:085cde657901 545 }
mbed_official 87:085cde657901 546
mbed_official 87:085cde657901 547 /**
mbed_official 87:085cde657901 548 * @brief Send an amount of data in non blocking mode
mbed_official 87:085cde657901 549 * @param hsc: usart handle
mbed_official 87:085cde657901 550 * @param pData: pointer to data buffer
mbed_official 87:085cde657901 551 * @param Size: amount of data to be sent
mbed_official 87:085cde657901 552 * @retval HAL status
mbed_official 87:085cde657901 553 */
mbed_official 87:085cde657901 554 HAL_StatusTypeDef HAL_SMARTCARD_Transmit_IT(SMARTCARD_HandleTypeDef *hsc, uint8_t *pData, uint16_t Size)
mbed_official 87:085cde657901 555 {
mbed_official 87:085cde657901 556 if(hsc->State == HAL_SMARTCARD_STATE_READY)
mbed_official 87:085cde657901 557 {
mbed_official 87:085cde657901 558 if((pData == NULL) || (Size == 0))
mbed_official 87:085cde657901 559 {
mbed_official 87:085cde657901 560 return HAL_ERROR;
mbed_official 87:085cde657901 561 }
mbed_official 87:085cde657901 562
mbed_official 87:085cde657901 563 /* Process Locked */
mbed_official 87:085cde657901 564 __HAL_LOCK(hsc);
mbed_official 87:085cde657901 565
mbed_official 87:085cde657901 566 hsc->pTxBuffPtr = pData;
mbed_official 87:085cde657901 567 hsc->TxXferSize = Size;
mbed_official 87:085cde657901 568 hsc->TxXferCount = Size;
mbed_official 87:085cde657901 569
mbed_official 87:085cde657901 570 hsc->ErrorCode = HAL_SMARTCARD_ERROR_NONE;
mbed_official 87:085cde657901 571 hsc->State = HAL_SMARTCARD_STATE_BUSY_TX;
mbed_official 87:085cde657901 572
mbed_official 87:085cde657901 573 /* Enable the SMARTCARD Parity Error Interrupt */
mbed_official 87:085cde657901 574 __SMARTCARD_ENABLE_IT(hsc, SMARTCARD_IT_PE);
mbed_official 87:085cde657901 575
mbed_official 87:085cde657901 576 /* Enable the SMARTCARD Error Interrupt: (Frame error, noise error, overrun error) */
mbed_official 87:085cde657901 577 __SMARTCARD_ENABLE_IT(hsc, SMARTCARD_IT_ERR);
mbed_official 87:085cde657901 578
mbed_official 87:085cde657901 579 /* Process Unlocked */
mbed_official 87:085cde657901 580 __HAL_UNLOCK(hsc);
mbed_official 87:085cde657901 581
mbed_official 87:085cde657901 582 /* Enable the SMARTCARD Transmit Complete Interrupt */
mbed_official 87:085cde657901 583 __SMARTCARD_ENABLE_IT(hsc, SMARTCARD_IT_TC);
mbed_official 87:085cde657901 584
mbed_official 87:085cde657901 585 return HAL_OK;
mbed_official 87:085cde657901 586 }
mbed_official 87:085cde657901 587 else
mbed_official 87:085cde657901 588 {
mbed_official 87:085cde657901 589 return HAL_BUSY;
mbed_official 87:085cde657901 590 }
mbed_official 87:085cde657901 591 }
mbed_official 87:085cde657901 592
mbed_official 87:085cde657901 593 /**
mbed_official 87:085cde657901 594 * @brief Receive an amount of data in non blocking mode
mbed_official 87:085cde657901 595 * @param hsc: usart handle
mbed_official 87:085cde657901 596 * @param pData: pointer to data buffer
mbed_official 87:085cde657901 597 * @param Size: amount of data to be received
mbed_official 87:085cde657901 598 * @retval HAL status
mbed_official 87:085cde657901 599 */
mbed_official 87:085cde657901 600 HAL_StatusTypeDef HAL_SMARTCARD_Receive_IT(SMARTCARD_HandleTypeDef *hsc, uint8_t *pData, uint16_t Size)
mbed_official 87:085cde657901 601 {
mbed_official 87:085cde657901 602 if(hsc->State == HAL_SMARTCARD_STATE_READY)
mbed_official 87:085cde657901 603 {
mbed_official 87:085cde657901 604 if((pData == NULL) || (Size == 0))
mbed_official 87:085cde657901 605 {
mbed_official 87:085cde657901 606 return HAL_ERROR;
mbed_official 87:085cde657901 607 }
mbed_official 87:085cde657901 608
mbed_official 87:085cde657901 609 /* Process Locked */
mbed_official 87:085cde657901 610 __HAL_LOCK(hsc);
mbed_official 87:085cde657901 611
mbed_official 87:085cde657901 612 hsc->pRxBuffPtr = pData;
mbed_official 87:085cde657901 613 hsc->RxXferSize = Size;
mbed_official 87:085cde657901 614 hsc->RxXferCount = Size;
mbed_official 87:085cde657901 615
mbed_official 87:085cde657901 616 hsc->ErrorCode = HAL_SMARTCARD_ERROR_NONE;
mbed_official 87:085cde657901 617 hsc->State = HAL_SMARTCARD_STATE_BUSY_RX;
mbed_official 87:085cde657901 618
mbed_official 87:085cde657901 619 /* Enable the SMARTCARD Data Register not empty Interrupt */
mbed_official 87:085cde657901 620 __SMARTCARD_ENABLE_IT(hsc, SMARTCARD_IT_RXNE);
mbed_official 87:085cde657901 621
mbed_official 87:085cde657901 622 /* Enable the SMARTCARD Parity Error Interrupt */
mbed_official 87:085cde657901 623 __SMARTCARD_ENABLE_IT(hsc, SMARTCARD_IT_PE);
mbed_official 87:085cde657901 624
mbed_official 87:085cde657901 625 /* Enable the SMARTCARD Error Interrupt: (Frame error, noise error, overrun error) */
mbed_official 87:085cde657901 626 __SMARTCARD_ENABLE_IT(hsc, SMARTCARD_IT_ERR);
mbed_official 87:085cde657901 627
mbed_official 87:085cde657901 628 /* Process Unlocked */
mbed_official 87:085cde657901 629 __HAL_UNLOCK(hsc);
mbed_official 87:085cde657901 630
mbed_official 87:085cde657901 631 return HAL_OK;
mbed_official 87:085cde657901 632 }
mbed_official 87:085cde657901 633 else
mbed_official 87:085cde657901 634 {
mbed_official 87:085cde657901 635 return HAL_BUSY;
mbed_official 87:085cde657901 636 }
mbed_official 87:085cde657901 637 }
mbed_official 87:085cde657901 638
mbed_official 87:085cde657901 639 /**
mbed_official 87:085cde657901 640 * @brief Send an amount of data in non blocking mode
mbed_official 87:085cde657901 641 * @param hsc: usart handle
mbed_official 87:085cde657901 642 * @param pData: pointer to data buffer
mbed_official 87:085cde657901 643 * @param Size: amount of data to be sent
mbed_official 87:085cde657901 644 * @retval HAL status
mbed_official 87:085cde657901 645 */
mbed_official 87:085cde657901 646 HAL_StatusTypeDef HAL_SMARTCARD_Transmit_DMA(SMARTCARD_HandleTypeDef *hsc, uint8_t *pData, uint16_t Size)
mbed_official 87:085cde657901 647 {
mbed_official 87:085cde657901 648 uint32_t *tmp;
mbed_official 87:085cde657901 649 uint32_t tmpstate;
mbed_official 87:085cde657901 650
mbed_official 87:085cde657901 651 tmpstate = hsc->State;
mbed_official 87:085cde657901 652 if((tmpstate == HAL_SMARTCARD_STATE_READY) || (tmpstate == HAL_SMARTCARD_STATE_BUSY_RX))
mbed_official 87:085cde657901 653 {
mbed_official 87:085cde657901 654 if((pData == NULL) || (Size == 0))
mbed_official 87:085cde657901 655 {
mbed_official 87:085cde657901 656 return HAL_ERROR;
mbed_official 87:085cde657901 657 }
mbed_official 87:085cde657901 658
mbed_official 87:085cde657901 659 /* Process Locked */
mbed_official 87:085cde657901 660 __HAL_LOCK(hsc);
mbed_official 87:085cde657901 661
mbed_official 87:085cde657901 662 hsc->pTxBuffPtr = pData;
mbed_official 87:085cde657901 663 hsc->TxXferSize = Size;
mbed_official 87:085cde657901 664 hsc->TxXferCount = Size;
mbed_official 87:085cde657901 665
mbed_official 87:085cde657901 666 hsc->ErrorCode = HAL_SMARTCARD_ERROR_NONE;
mbed_official 87:085cde657901 667 hsc->State = HAL_SMARTCARD_STATE_BUSY_TX;
mbed_official 87:085cde657901 668
mbed_official 87:085cde657901 669 /* Set the SMARTCARD DMA transfert complete callback */
mbed_official 87:085cde657901 670 hsc->hdmatx->XferCpltCallback = SMARTCARD_DMATransmitCplt;
mbed_official 87:085cde657901 671
mbed_official 87:085cde657901 672 /* Set the DMA error callback */
mbed_official 87:085cde657901 673 hsc->hdmatx->XferErrorCallback = SMARTCARD_DMAError;
mbed_official 87:085cde657901 674
mbed_official 87:085cde657901 675 /* Enable the SMARTCARD transmit DMA Stream */
mbed_official 87:085cde657901 676 tmp = (uint32_t*)&pData;
mbed_official 87:085cde657901 677 HAL_DMA_Start_IT(hsc->hdmatx, *(uint32_t*)tmp, (uint32_t)&hsc->Instance->DR, Size);
mbed_official 87:085cde657901 678
mbed_official 87:085cde657901 679 /* Enable the DMA transfer for transmit request by setting the DMAT bit
mbed_official 87:085cde657901 680 in the SMARTCARD CR3 register */
mbed_official 87:085cde657901 681 hsc->Instance->CR3 |= USART_CR3_DMAT;
mbed_official 87:085cde657901 682
mbed_official 87:085cde657901 683 /* Process Unlocked */
mbed_official 87:085cde657901 684 __HAL_UNLOCK(hsc);
mbed_official 87:085cde657901 685
mbed_official 87:085cde657901 686 return HAL_OK;
mbed_official 87:085cde657901 687 }
mbed_official 87:085cde657901 688 else
mbed_official 87:085cde657901 689 {
mbed_official 87:085cde657901 690 return HAL_BUSY;
mbed_official 87:085cde657901 691 }
mbed_official 87:085cde657901 692 }
mbed_official 87:085cde657901 693
mbed_official 87:085cde657901 694 /**
mbed_official 87:085cde657901 695 * @brief Receive an amount of data in non blocking mode
mbed_official 87:085cde657901 696 * @param hsc: usart handle
mbed_official 87:085cde657901 697 * @param pData: pointer to data buffer
mbed_official 87:085cde657901 698 * @param Size: amount of data to be received
mbed_official 87:085cde657901 699 * @note When the SMARTCARD parity is enabled (PCE = 1) the data received contain the parity bit.s
mbed_official 87:085cde657901 700 * @retval HAL status
mbed_official 87:085cde657901 701 */
mbed_official 87:085cde657901 702 HAL_StatusTypeDef HAL_SMARTCARD_Receive_DMA(SMARTCARD_HandleTypeDef *hsc, uint8_t *pData, uint16_t Size)
mbed_official 87:085cde657901 703 {
mbed_official 87:085cde657901 704 uint32_t *tmp;
mbed_official 87:085cde657901 705 uint32_t tmpstate;
mbed_official 87:085cde657901 706
mbed_official 87:085cde657901 707 tmpstate = hsc->State;
mbed_official 87:085cde657901 708 if((tmpstate == HAL_SMARTCARD_STATE_READY) || (tmpstate == HAL_SMARTCARD_STATE_BUSY_TX))
mbed_official 87:085cde657901 709 {
mbed_official 87:085cde657901 710 if((pData == NULL) || (Size == 0))
mbed_official 87:085cde657901 711 {
mbed_official 87:085cde657901 712 return HAL_ERROR;
mbed_official 87:085cde657901 713 }
mbed_official 87:085cde657901 714
mbed_official 87:085cde657901 715 /* Process Locked */
mbed_official 87:085cde657901 716 __HAL_LOCK(hsc);
mbed_official 87:085cde657901 717
mbed_official 87:085cde657901 718 hsc->pRxBuffPtr = pData;
mbed_official 87:085cde657901 719 hsc->RxXferSize = Size;
mbed_official 87:085cde657901 720
mbed_official 87:085cde657901 721 hsc->ErrorCode = HAL_SMARTCARD_ERROR_NONE;
mbed_official 87:085cde657901 722 hsc->State = HAL_SMARTCARD_STATE_BUSY_RX;
mbed_official 87:085cde657901 723
mbed_official 87:085cde657901 724 /* Set the SMARTCARD DMA transfert complete callback */
mbed_official 87:085cde657901 725 hsc->hdmarx->XferCpltCallback = SMARTCARD_DMAReceiveCplt;
mbed_official 87:085cde657901 726
mbed_official 87:085cde657901 727 /* Set the DMA error callback */
mbed_official 87:085cde657901 728 hsc->hdmarx->XferErrorCallback = SMARTCARD_DMAError;
mbed_official 87:085cde657901 729
mbed_official 87:085cde657901 730 /* Enable the DMA Stream */
mbed_official 87:085cde657901 731 tmp = (uint32_t*)&pData;
mbed_official 87:085cde657901 732 HAL_DMA_Start_IT(hsc->hdmarx, (uint32_t)&hsc->Instance->DR, *(uint32_t*)tmp, Size);
mbed_official 87:085cde657901 733
mbed_official 87:085cde657901 734 /* Enable the DMA transfer for the receiver request by setting the DMAR bit
mbed_official 87:085cde657901 735 in the SMARTCARD CR3 register */
mbed_official 87:085cde657901 736 hsc->Instance->CR3 |= USART_CR3_DMAR;
mbed_official 87:085cde657901 737
mbed_official 87:085cde657901 738 /* Process Unlocked */
mbed_official 87:085cde657901 739 __HAL_UNLOCK(hsc);
mbed_official 87:085cde657901 740
mbed_official 87:085cde657901 741 return HAL_OK;
mbed_official 87:085cde657901 742 }
mbed_official 87:085cde657901 743 else
mbed_official 87:085cde657901 744 {
mbed_official 87:085cde657901 745 return HAL_BUSY;
mbed_official 87:085cde657901 746 }
mbed_official 87:085cde657901 747 }
mbed_official 87:085cde657901 748
mbed_official 87:085cde657901 749 /**
mbed_official 87:085cde657901 750 * @brief This function handles SMARTCARD interrupt request.
mbed_official 87:085cde657901 751 * @param hsc: usart handle
mbed_official 87:085cde657901 752 * @retval None
mbed_official 87:085cde657901 753 */
mbed_official 87:085cde657901 754 void HAL_SMARTCARD_IRQHandler(SMARTCARD_HandleTypeDef *hsc)
mbed_official 87:085cde657901 755 {
mbed_official 87:085cde657901 756 uint32_t tmp1 = 0, tmp2 = 0;
mbed_official 87:085cde657901 757
mbed_official 87:085cde657901 758 tmp1 = __HAL_SMARTCARD_GET_FLAG(hsc, SMARTCARD_FLAG_PE);
mbed_official 87:085cde657901 759 tmp2 = __HAL_SMARTCARD_GET_IT_SOURCE(hsc, SMARTCARD_IT_PE);
mbed_official 87:085cde657901 760 /* SMARTCARD parity error interrupt occured --------------------------------*/
mbed_official 87:085cde657901 761 if((tmp1 != RESET) && (tmp2 != RESET))
mbed_official 87:085cde657901 762 {
mbed_official 87:085cde657901 763 __HAL_SMARTCARD_CLEAR_FLAG(hsc, SMARTCARD_FLAG_PE);
mbed_official 87:085cde657901 764 hsc->ErrorCode |= HAL_SMARTCARD_ERROR_PE;
mbed_official 87:085cde657901 765 }
mbed_official 87:085cde657901 766
mbed_official 87:085cde657901 767 tmp1 = __HAL_SMARTCARD_GET_FLAG(hsc, SMARTCARD_FLAG_FE);
mbed_official 87:085cde657901 768 tmp2 = __HAL_SMARTCARD_GET_IT_SOURCE(hsc, SMARTCARD_IT_ERR);
mbed_official 87:085cde657901 769 /* SMARTCARD frame error interrupt occured ---------------------------------*/
mbed_official 87:085cde657901 770 if((tmp1 != RESET) && (tmp2 != RESET))
mbed_official 87:085cde657901 771 {
mbed_official 87:085cde657901 772 __HAL_SMARTCARD_CLEAR_FLAG(hsc, SMARTCARD_FLAG_FE);
mbed_official 87:085cde657901 773 hsc->ErrorCode |= HAL_SMARTCARD_ERROR_FE;
mbed_official 87:085cde657901 774 }
mbed_official 87:085cde657901 775
mbed_official 87:085cde657901 776 tmp1 = __HAL_SMARTCARD_GET_FLAG(hsc, SMARTCARD_FLAG_NE);
mbed_official 87:085cde657901 777 tmp2 = __HAL_SMARTCARD_GET_IT_SOURCE(hsc, SMARTCARD_IT_ERR);
mbed_official 87:085cde657901 778 /* SMARTCARD noise error interrupt occured ---------------------------------*/
mbed_official 87:085cde657901 779 if((tmp1 != RESET) && (tmp2 != RESET))
mbed_official 87:085cde657901 780 {
mbed_official 87:085cde657901 781 __HAL_SMARTCARD_CLEAR_FLAG(hsc, SMARTCARD_FLAG_NE);
mbed_official 87:085cde657901 782 hsc->ErrorCode |= HAL_SMARTCARD_ERROR_NE;
mbed_official 87:085cde657901 783 }
mbed_official 87:085cde657901 784
mbed_official 87:085cde657901 785 tmp1 = __HAL_SMARTCARD_GET_FLAG(hsc, SMARTCARD_FLAG_ORE);
mbed_official 87:085cde657901 786 tmp2 = __HAL_SMARTCARD_GET_IT_SOURCE(hsc, SMARTCARD_IT_ERR);
mbed_official 87:085cde657901 787 /* SMARTCARD Over-Run interrupt occured ------------------------------------*/
mbed_official 87:085cde657901 788 if((tmp1 != RESET) && (tmp2 != RESET))
mbed_official 87:085cde657901 789 {
mbed_official 87:085cde657901 790 __HAL_SMARTCARD_CLEAR_FLAG(hsc, SMARTCARD_FLAG_ORE);
mbed_official 87:085cde657901 791 hsc->ErrorCode |= HAL_SMARTCARD_ERROR_ORE;
mbed_official 87:085cde657901 792 }
mbed_official 87:085cde657901 793
mbed_official 87:085cde657901 794 tmp1 = __HAL_SMARTCARD_GET_FLAG(hsc, SMARTCARD_FLAG_RXNE);
mbed_official 87:085cde657901 795 tmp2 = __HAL_SMARTCARD_GET_IT_SOURCE(hsc, SMARTCARD_IT_RXNE);
mbed_official 87:085cde657901 796 /* SMARTCARD in mode Receiver ----------------------------------------------*/
mbed_official 87:085cde657901 797 if((tmp1 != RESET) && (tmp2 != RESET))
mbed_official 87:085cde657901 798 {
mbed_official 87:085cde657901 799 SMARTCARD_Receive_IT(hsc);
mbed_official 87:085cde657901 800 __HAL_SMARTCARD_CLEAR_FLAG(hsc, SMARTCARD_FLAG_RXNE);
mbed_official 87:085cde657901 801 }
mbed_official 87:085cde657901 802
mbed_official 87:085cde657901 803 tmp1 = __HAL_SMARTCARD_GET_FLAG(hsc, SMARTCARD_FLAG_TC);
mbed_official 87:085cde657901 804 tmp2 = __HAL_SMARTCARD_GET_IT_SOURCE(hsc, SMARTCARD_IT_TC);
mbed_official 87:085cde657901 805 /* SMARTCARD in mode Transmitter -------------------------------------------*/
mbed_official 87:085cde657901 806 if((tmp1 != RESET) && (tmp2 != RESET))
mbed_official 87:085cde657901 807 {
mbed_official 87:085cde657901 808 SMARTCARD_Transmit_IT(hsc);
mbed_official 87:085cde657901 809 __HAL_SMARTCARD_CLEAR_FLAG(hsc, SMARTCARD_FLAG_TC);
mbed_official 87:085cde657901 810 }
mbed_official 87:085cde657901 811
mbed_official 87:085cde657901 812 /* Call the Error call Back in case of Errors */
mbed_official 87:085cde657901 813 if(hsc->ErrorCode != HAL_SMARTCARD_ERROR_NONE)
mbed_official 87:085cde657901 814 {
mbed_official 87:085cde657901 815 /* Set the SMARTCARD state ready to be able to start again the process */
mbed_official 87:085cde657901 816 hsc->State= HAL_SMARTCARD_STATE_READY;
mbed_official 87:085cde657901 817 HAL_SMARTCARD_ErrorCallback(hsc);
mbed_official 87:085cde657901 818 }
mbed_official 87:085cde657901 819 }
mbed_official 87:085cde657901 820
mbed_official 87:085cde657901 821 /**
mbed_official 87:085cde657901 822 * @brief Tx Transfer completed callbacks
mbed_official 87:085cde657901 823 * @param hsc: usart handle
mbed_official 87:085cde657901 824 * @retval None
mbed_official 87:085cde657901 825 */
mbed_official 87:085cde657901 826 __weak void HAL_SMARTCARD_TxCpltCallback(SMARTCARD_HandleTypeDef *hsc)
mbed_official 87:085cde657901 827 {
mbed_official 87:085cde657901 828 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 829 the HAL_SMARTCARD_TxCpltCallback could be implemented in the user file
mbed_official 87:085cde657901 830 */
mbed_official 87:085cde657901 831 }
mbed_official 87:085cde657901 832
mbed_official 87:085cde657901 833 /**
mbed_official 87:085cde657901 834 * @brief Rx Transfer completed callbacks
mbed_official 87:085cde657901 835 * @param hsc: usart handle
mbed_official 87:085cde657901 836 * @retval None
mbed_official 87:085cde657901 837 */
mbed_official 87:085cde657901 838 __weak void HAL_SMARTCARD_RxCpltCallback(SMARTCARD_HandleTypeDef *hsc)
mbed_official 87:085cde657901 839 {
mbed_official 87:085cde657901 840 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 841 the HAL_SMARTCARD_TxCpltCallback could be implemented in the user file
mbed_official 87:085cde657901 842 */
mbed_official 87:085cde657901 843 }
mbed_official 87:085cde657901 844
mbed_official 87:085cde657901 845 /**
mbed_official 87:085cde657901 846 * @brief SMARTCARD error callbacks
mbed_official 87:085cde657901 847 * @param hsc: usart handle
mbed_official 87:085cde657901 848 * @retval None
mbed_official 87:085cde657901 849 */
mbed_official 87:085cde657901 850 __weak void HAL_SMARTCARD_ErrorCallback(SMARTCARD_HandleTypeDef *hsc)
mbed_official 87:085cde657901 851 {
mbed_official 87:085cde657901 852 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 87:085cde657901 853 the HAL_SMARTCARD_ErrorCallback could be implemented in the user file
mbed_official 87:085cde657901 854 */
mbed_official 87:085cde657901 855 }
mbed_official 87:085cde657901 856
mbed_official 87:085cde657901 857 /**
mbed_official 87:085cde657901 858 * @}
mbed_official 87:085cde657901 859 */
mbed_official 87:085cde657901 860
mbed_official 87:085cde657901 861 /** @defgroup SMARTCARD_Group3 Peripheral State and Errors functions
mbed_official 87:085cde657901 862 * @brief SMARTCARD State and Errors functions
mbed_official 87:085cde657901 863 *
mbed_official 87:085cde657901 864 @verbatim
mbed_official 87:085cde657901 865 ===============================================================================
mbed_official 87:085cde657901 866 ##### Peripheral State and Errors functions #####
mbed_official 87:085cde657901 867 ===============================================================================
mbed_official 87:085cde657901 868 [..]
mbed_official 87:085cde657901 869 This subsection provides a set of functions allowing to control the SmartCard.
mbed_official 87:085cde657901 870 (+) HAL_SMARTCARD_GetState() API can be helpful to check in run-time the state of the SmartCard peripheral.
mbed_official 87:085cde657901 871 (+) HAL_SMARTCARD_GetError() check in run-time errors that could be occured durung communication.
mbed_official 87:085cde657901 872 @endverbatim
mbed_official 87:085cde657901 873 * @{
mbed_official 87:085cde657901 874 */
mbed_official 87:085cde657901 875
mbed_official 87:085cde657901 876 /**
mbed_official 87:085cde657901 877 * @brief return the SMARTCARD state
mbed_official 87:085cde657901 878 * @param hsc: usart handle
mbed_official 87:085cde657901 879 * @retval HAL state
mbed_official 87:085cde657901 880 */
mbed_official 87:085cde657901 881 HAL_SMARTCARD_StateTypeDef HAL_SMARTCARD_GetState(SMARTCARD_HandleTypeDef *hsc)
mbed_official 87:085cde657901 882 {
mbed_official 87:085cde657901 883 return hsc->State;
mbed_official 87:085cde657901 884 }
mbed_official 87:085cde657901 885
mbed_official 87:085cde657901 886 /**
mbed_official 87:085cde657901 887 * @brief Return the SMARTCARD error code
mbed_official 87:085cde657901 888 * @param hsc : pointer to a SMARTCARD_HandleTypeDef structure that contains
mbed_official 87:085cde657901 889 * the configuration information for the specified SMARTCARD.
mbed_official 87:085cde657901 890 * @retval SMARTCARD Error Code
mbed_official 87:085cde657901 891 */
mbed_official 87:085cde657901 892 uint32_t HAL_SMARTCARD_GetError(SMARTCARD_HandleTypeDef *hsc)
mbed_official 87:085cde657901 893 {
mbed_official 87:085cde657901 894 return hsc->ErrorCode;
mbed_official 87:085cde657901 895 }
mbed_official 87:085cde657901 896
mbed_official 87:085cde657901 897 /**
mbed_official 87:085cde657901 898 * @}
mbed_official 87:085cde657901 899 */
mbed_official 87:085cde657901 900
mbed_official 87:085cde657901 901 /**
mbed_official 87:085cde657901 902 * @brief DMA SMARTCARD transmit process complete callback
mbed_official 87:085cde657901 903 * @param hdma : DMA handle
mbed_official 87:085cde657901 904 * @retval None
mbed_official 87:085cde657901 905 */
mbed_official 106:ced8cbb51063 906 static void SMARTCARD_DMATransmitCplt(DMA_HandleTypeDef *hdma)
mbed_official 87:085cde657901 907 {
mbed_official 87:085cde657901 908 SMARTCARD_HandleTypeDef* hsc = ( SMARTCARD_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 87:085cde657901 909
mbed_official 87:085cde657901 910 hsc->TxXferCount = 0;
mbed_official 87:085cde657901 911
mbed_official 87:085cde657901 912 /* Disable the DMA transfer for transmit request by setting the DMAT bit
mbed_official 87:085cde657901 913 in the USART CR3 register */
mbed_official 87:085cde657901 914 hsc->Instance->CR3 &= (uint32_t)~((uint32_t)USART_CR3_DMAT);
mbed_official 106:ced8cbb51063 915
mbed_official 106:ced8cbb51063 916 /* Wait for SMARTCARD TC Flag */
mbed_official 106:ced8cbb51063 917 if(SMARTCARD_WaitOnFlagUntilTimeout(hsc, SMARTCARD_FLAG_TC, RESET, SMARTCARD_TIMEOUT_VALUE) != HAL_OK)
mbed_official 106:ced8cbb51063 918 {
mbed_official 106:ced8cbb51063 919 /* Timeout Occured */
mbed_official 106:ced8cbb51063 920 hsc->State = HAL_SMARTCARD_STATE_TIMEOUT;
mbed_official 106:ced8cbb51063 921 HAL_SMARTCARD_ErrorCallback(hsc);
mbed_official 106:ced8cbb51063 922 }
mbed_official 106:ced8cbb51063 923 else
mbed_official 106:ced8cbb51063 924 {
mbed_official 106:ced8cbb51063 925 /* No Timeout */
mbed_official 106:ced8cbb51063 926 hsc->State= HAL_SMARTCARD_STATE_READY;
mbed_official 106:ced8cbb51063 927 HAL_SMARTCARD_TxCpltCallback(hsc);
mbed_official 106:ced8cbb51063 928 }
mbed_official 87:085cde657901 929 }
mbed_official 87:085cde657901 930
mbed_official 87:085cde657901 931 /**
mbed_official 87:085cde657901 932 * @brief DMA SMARTCARD receive process complete callback
mbed_official 87:085cde657901 933 * @param hdma : DMA handle
mbed_official 87:085cde657901 934 * @retval None
mbed_official 87:085cde657901 935 */
mbed_official 87:085cde657901 936 static void SMARTCARD_DMAReceiveCplt(DMA_HandleTypeDef *hdma)
mbed_official 87:085cde657901 937 {
mbed_official 87:085cde657901 938 SMARTCARD_HandleTypeDef* hsc = ( SMARTCARD_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 87:085cde657901 939
mbed_official 87:085cde657901 940 hsc->RxXferCount = 0;
mbed_official 87:085cde657901 941
mbed_official 87:085cde657901 942 /* Disable the DMA transfer for the receiver request by setting the DMAR bit
mbed_official 87:085cde657901 943 in the USART CR3 register */
mbed_official 87:085cde657901 944 hsc->Instance->CR3 &= (uint32_t)~((uint32_t)USART_CR3_DMAR);
mbed_official 87:085cde657901 945
mbed_official 87:085cde657901 946 hsc->State= HAL_SMARTCARD_STATE_READY;
mbed_official 87:085cde657901 947
mbed_official 87:085cde657901 948 HAL_SMARTCARD_RxCpltCallback(hsc);
mbed_official 87:085cde657901 949 }
mbed_official 87:085cde657901 950
mbed_official 87:085cde657901 951 /**
mbed_official 87:085cde657901 952 * @brief DMA SMARTCARD communication error callback
mbed_official 87:085cde657901 953 * @param hdma : DMA handle
mbed_official 87:085cde657901 954 * @retval None
mbed_official 87:085cde657901 955 */
mbed_official 87:085cde657901 956 static void SMARTCARD_DMAError(DMA_HandleTypeDef *hdma)
mbed_official 87:085cde657901 957 {
mbed_official 87:085cde657901 958 SMARTCARD_HandleTypeDef* hsc = ( SMARTCARD_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 87:085cde657901 959
mbed_official 87:085cde657901 960 hsc->RxXferCount = 0;
mbed_official 87:085cde657901 961 hsc->TxXferCount = 0;
mbed_official 87:085cde657901 962 hsc->ErrorCode = HAL_SMARTCARD_ERROR_DMA;
mbed_official 87:085cde657901 963 hsc->State= HAL_SMARTCARD_STATE_READY;
mbed_official 87:085cde657901 964
mbed_official 87:085cde657901 965 HAL_SMARTCARD_ErrorCallback(hsc);
mbed_official 87:085cde657901 966 }
mbed_official 87:085cde657901 967
mbed_official 87:085cde657901 968 /**
mbed_official 87:085cde657901 969 * @brief This function handles SMARTCARD Communication Timeout.
mbed_official 87:085cde657901 970 * @param hsc: SMARTCARD handle
mbed_official 87:085cde657901 971 * @param Flag: specifies the SMARTCARD flag to check.
mbed_official 87:085cde657901 972 * @param Status: The new Flag status (SET or RESET).
mbed_official 87:085cde657901 973 * @param Timeout: Timeout duration
mbed_official 87:085cde657901 974 * @retval HAL status
mbed_official 87:085cde657901 975 */
mbed_official 87:085cde657901 976 static HAL_StatusTypeDef SMARTCARD_WaitOnFlagUntilTimeout(SMARTCARD_HandleTypeDef *hsc, uint32_t Flag, FlagStatus Status, uint32_t Timeout)
mbed_official 87:085cde657901 977 {
mbed_official 87:085cde657901 978 uint32_t timeout = 0;
mbed_official 87:085cde657901 979
mbed_official 87:085cde657901 980 timeout = HAL_GetTick() + Timeout;
mbed_official 87:085cde657901 981
mbed_official 87:085cde657901 982 /* Wait until flag is set */
mbed_official 87:085cde657901 983 if(Status == RESET)
mbed_official 87:085cde657901 984 {
mbed_official 87:085cde657901 985 while(__HAL_SMARTCARD_GET_FLAG(hsc, Flag) == RESET)
mbed_official 87:085cde657901 986 {
mbed_official 87:085cde657901 987 /* Check for the Timeout */
mbed_official 87:085cde657901 988 if(Timeout != HAL_MAX_DELAY)
mbed_official 87:085cde657901 989 {
mbed_official 87:085cde657901 990 if(HAL_GetTick() >= timeout)
mbed_official 87:085cde657901 991 {
mbed_official 87:085cde657901 992 /* Disable TXE and RXNE interrupts for the interrupt process */
mbed_official 87:085cde657901 993 __SMARTCARD_DISABLE_IT(hsc, SMARTCARD_IT_TXE);
mbed_official 87:085cde657901 994 __SMARTCARD_DISABLE_IT(hsc, SMARTCARD_IT_RXNE);
mbed_official 87:085cde657901 995
mbed_official 87:085cde657901 996 hsc->State= HAL_SMARTCARD_STATE_READY;
mbed_official 87:085cde657901 997
mbed_official 87:085cde657901 998 /* Process Unlocked */
mbed_official 87:085cde657901 999 __HAL_UNLOCK(hsc);
mbed_official 87:085cde657901 1000
mbed_official 87:085cde657901 1001 return HAL_TIMEOUT;
mbed_official 87:085cde657901 1002 }
mbed_official 87:085cde657901 1003 }
mbed_official 87:085cde657901 1004 }
mbed_official 87:085cde657901 1005 }
mbed_official 87:085cde657901 1006 else
mbed_official 87:085cde657901 1007 {
mbed_official 87:085cde657901 1008 while(__HAL_SMARTCARD_GET_FLAG(hsc, Flag) != RESET)
mbed_official 87:085cde657901 1009 {
mbed_official 87:085cde657901 1010 /* Check for the Timeout */
mbed_official 87:085cde657901 1011 if(Timeout != HAL_MAX_DELAY)
mbed_official 87:085cde657901 1012 {
mbed_official 87:085cde657901 1013 if(HAL_GetTick() >= timeout)
mbed_official 87:085cde657901 1014 {
mbed_official 87:085cde657901 1015 /* Disable TXE and RXNE interrupts for the interrupt process */
mbed_official 87:085cde657901 1016 __SMARTCARD_DISABLE_IT(hsc, SMARTCARD_IT_TXE);
mbed_official 87:085cde657901 1017 __SMARTCARD_DISABLE_IT(hsc, SMARTCARD_IT_RXNE);
mbed_official 87:085cde657901 1018
mbed_official 87:085cde657901 1019 hsc->State= HAL_SMARTCARD_STATE_READY;
mbed_official 87:085cde657901 1020
mbed_official 87:085cde657901 1021 /* Process Unlocked */
mbed_official 87:085cde657901 1022 __HAL_UNLOCK(hsc);
mbed_official 87:085cde657901 1023
mbed_official 87:085cde657901 1024 return HAL_TIMEOUT;
mbed_official 87:085cde657901 1025 }
mbed_official 87:085cde657901 1026 }
mbed_official 87:085cde657901 1027 }
mbed_official 87:085cde657901 1028 }
mbed_official 87:085cde657901 1029 return HAL_OK;
mbed_official 87:085cde657901 1030 }
mbed_official 87:085cde657901 1031
mbed_official 87:085cde657901 1032 /**
mbed_official 87:085cde657901 1033 * @brief Send an amount of data in non blocking mode
mbed_official 87:085cde657901 1034 * @param hsc: usart handle
mbed_official 87:085cde657901 1035 * @retval HAL status
mbed_official 87:085cde657901 1036 */
mbed_official 87:085cde657901 1037 static HAL_StatusTypeDef SMARTCARD_Transmit_IT(SMARTCARD_HandleTypeDef *hsc)
mbed_official 87:085cde657901 1038 {
mbed_official 87:085cde657901 1039 uint16_t* tmp;
mbed_official 87:085cde657901 1040
mbed_official 87:085cde657901 1041 if(hsc->State == HAL_SMARTCARD_STATE_BUSY_TX)
mbed_official 87:085cde657901 1042 {
mbed_official 87:085cde657901 1043 /* Process Locked */
mbed_official 87:085cde657901 1044 __HAL_LOCK(hsc);
mbed_official 87:085cde657901 1045
mbed_official 87:085cde657901 1046 if(hsc->Init.WordLength == SMARTCARD_WORDLENGTH_9B)
mbed_official 87:085cde657901 1047 {
mbed_official 87:085cde657901 1048 tmp = (uint16_t*) hsc->pTxBuffPtr;
mbed_official 87:085cde657901 1049 hsc->Instance->DR = (uint16_t)(*tmp & (uint16_t)0x01FF);
mbed_official 87:085cde657901 1050 if(hsc->Init.Parity == SMARTCARD_PARITY_NONE)
mbed_official 87:085cde657901 1051 {
mbed_official 87:085cde657901 1052 hsc->pTxBuffPtr += 2;
mbed_official 87:085cde657901 1053 }
mbed_official 87:085cde657901 1054 else
mbed_official 87:085cde657901 1055 {
mbed_official 87:085cde657901 1056 hsc->pTxBuffPtr += 1;
mbed_official 87:085cde657901 1057 }
mbed_official 87:085cde657901 1058 }
mbed_official 87:085cde657901 1059 else
mbed_official 87:085cde657901 1060 {
mbed_official 87:085cde657901 1061 hsc->Instance->DR = (uint8_t)(*hsc->pTxBuffPtr++ & (uint8_t)0x00FF);
mbed_official 87:085cde657901 1062 }
mbed_official 87:085cde657901 1063
mbed_official 87:085cde657901 1064 if(--hsc->TxXferCount == 0)
mbed_official 87:085cde657901 1065 {
mbed_official 87:085cde657901 1066 /* Disable the SMARTCARD Transmit Complete Interrupt */
mbed_official 87:085cde657901 1067 __SMARTCARD_DISABLE_IT(hsc, SMARTCARD_IT_TC);
mbed_official 87:085cde657901 1068
mbed_official 87:085cde657901 1069 /* Disable the SMARTCARD Parity Error Interrupt */
mbed_official 87:085cde657901 1070 __SMARTCARD_DISABLE_IT(hsc, SMARTCARD_IT_PE);
mbed_official 87:085cde657901 1071
mbed_official 87:085cde657901 1072 /* Disable the SMARTCARD Error Interrupt: (Frame error, noise error, overrun error) */
mbed_official 87:085cde657901 1073 __SMARTCARD_DISABLE_IT(hsc, SMARTCARD_IT_ERR);
mbed_official 87:085cde657901 1074
mbed_official 87:085cde657901 1075 hsc->State = HAL_SMARTCARD_STATE_READY;
mbed_official 87:085cde657901 1076
mbed_official 87:085cde657901 1077 /* Call the Process Unlocked before calling the Tx call back API to give the possibiity to
mbed_official 87:085cde657901 1078 start again the Transmission under the Tx call back API */
mbed_official 87:085cde657901 1079 __HAL_UNLOCK(hsc);
mbed_official 87:085cde657901 1080
mbed_official 87:085cde657901 1081 HAL_SMARTCARD_TxCpltCallback(hsc);
mbed_official 87:085cde657901 1082
mbed_official 87:085cde657901 1083 return HAL_OK;
mbed_official 87:085cde657901 1084 }
mbed_official 87:085cde657901 1085
mbed_official 87:085cde657901 1086 /* Process Unlocked */
mbed_official 87:085cde657901 1087 __HAL_UNLOCK(hsc);
mbed_official 87:085cde657901 1088
mbed_official 87:085cde657901 1089 return HAL_OK;
mbed_official 87:085cde657901 1090 }
mbed_official 87:085cde657901 1091 else
mbed_official 87:085cde657901 1092 {
mbed_official 87:085cde657901 1093 return HAL_BUSY;
mbed_official 87:085cde657901 1094 }
mbed_official 87:085cde657901 1095 }
mbed_official 87:085cde657901 1096
mbed_official 87:085cde657901 1097 /**
mbed_official 87:085cde657901 1098 * @brief Receive an amount of data in non blocking mode
mbed_official 87:085cde657901 1099 * @param hsc: usart handle
mbed_official 87:085cde657901 1100 * @retval HAL status
mbed_official 87:085cde657901 1101 */
mbed_official 87:085cde657901 1102 static HAL_StatusTypeDef SMARTCARD_Receive_IT(SMARTCARD_HandleTypeDef *hsc)
mbed_official 87:085cde657901 1103 {
mbed_official 87:085cde657901 1104 uint16_t* tmp;
mbed_official 87:085cde657901 1105
mbed_official 87:085cde657901 1106 if(hsc->State == HAL_SMARTCARD_STATE_BUSY_RX)
mbed_official 87:085cde657901 1107 {
mbed_official 87:085cde657901 1108 /* Process Locked */
mbed_official 87:085cde657901 1109 __HAL_LOCK(hsc);
mbed_official 87:085cde657901 1110
mbed_official 87:085cde657901 1111 if(hsc->Init.WordLength == SMARTCARD_WORDLENGTH_9B)
mbed_official 87:085cde657901 1112 {
mbed_official 87:085cde657901 1113 tmp = (uint16_t*) hsc->pRxBuffPtr;
mbed_official 87:085cde657901 1114 if(hsc->Init.Parity == SMARTCARD_PARITY_NONE)
mbed_official 87:085cde657901 1115 {
mbed_official 87:085cde657901 1116 *tmp = (uint16_t)(hsc->Instance->DR & (uint16_t)0x01FF);
mbed_official 87:085cde657901 1117 hsc->pRxBuffPtr += 2;
mbed_official 87:085cde657901 1118 }
mbed_official 87:085cde657901 1119 else
mbed_official 87:085cde657901 1120 {
mbed_official 87:085cde657901 1121 *tmp = (uint16_t)(hsc->Instance->DR & (uint16_t)0x00FF);
mbed_official 87:085cde657901 1122 hsc->pRxBuffPtr += 1;
mbed_official 87:085cde657901 1123 }
mbed_official 87:085cde657901 1124 }
mbed_official 87:085cde657901 1125 else
mbed_official 87:085cde657901 1126 {
mbed_official 87:085cde657901 1127 if(hsc->Init.Parity == SMARTCARD_PARITY_NONE)
mbed_official 87:085cde657901 1128 {
mbed_official 87:085cde657901 1129 *hsc->pRxBuffPtr++ = (uint8_t)(hsc->Instance->DR & (uint8_t)0x00FF);
mbed_official 87:085cde657901 1130 }
mbed_official 87:085cde657901 1131 else
mbed_official 87:085cde657901 1132 {
mbed_official 87:085cde657901 1133 *hsc->pRxBuffPtr++ = (uint8_t)(hsc->Instance->DR & (uint8_t)0x007F);
mbed_official 87:085cde657901 1134 }
mbed_official 87:085cde657901 1135 }
mbed_official 87:085cde657901 1136
mbed_official 87:085cde657901 1137 if(--hsc->RxXferCount == 0)
mbed_official 87:085cde657901 1138 {
mbed_official 87:085cde657901 1139 while(HAL_IS_BIT_SET(hsc->Instance->SR, SMARTCARD_FLAG_RXNE))
mbed_official 87:085cde657901 1140 {
mbed_official 87:085cde657901 1141 }
mbed_official 87:085cde657901 1142 __SMARTCARD_DISABLE_IT(hsc, SMARTCARD_IT_RXNE);
mbed_official 87:085cde657901 1143
mbed_official 87:085cde657901 1144 /* Disable the SMARTCARD Parity Error Interrupt */
mbed_official 87:085cde657901 1145 __SMARTCARD_DISABLE_IT(hsc, SMARTCARD_IT_PE);
mbed_official 87:085cde657901 1146
mbed_official 87:085cde657901 1147 /* Disable the SMARTCARD Error Interrupt: (Frame error, noise error, overrun error) */
mbed_official 87:085cde657901 1148 __SMARTCARD_DISABLE_IT(hsc, SMARTCARD_IT_ERR);
mbed_official 87:085cde657901 1149
mbed_official 87:085cde657901 1150 hsc->State = HAL_SMARTCARD_STATE_READY;
mbed_official 87:085cde657901 1151
mbed_official 87:085cde657901 1152 /* Call the Process Unlocked before calling the Rx call back API to give the possibiity to
mbed_official 87:085cde657901 1153 start again the receiption under the Rx call back API */
mbed_official 87:085cde657901 1154 __HAL_UNLOCK(hsc);
mbed_official 87:085cde657901 1155
mbed_official 87:085cde657901 1156 HAL_SMARTCARD_RxCpltCallback(hsc);
mbed_official 87:085cde657901 1157
mbed_official 87:085cde657901 1158 return HAL_OK;
mbed_official 87:085cde657901 1159 }
mbed_official 87:085cde657901 1160
mbed_official 87:085cde657901 1161 /* Process Unlocked */
mbed_official 87:085cde657901 1162 __HAL_UNLOCK(hsc);
mbed_official 87:085cde657901 1163
mbed_official 87:085cde657901 1164 return HAL_OK;
mbed_official 87:085cde657901 1165 }
mbed_official 87:085cde657901 1166 else
mbed_official 87:085cde657901 1167 {
mbed_official 87:085cde657901 1168 return HAL_BUSY;
mbed_official 87:085cde657901 1169 }
mbed_official 87:085cde657901 1170 }
mbed_official 87:085cde657901 1171
mbed_official 87:085cde657901 1172 /**
mbed_official 87:085cde657901 1173 * @brief Configure the SMARTCARD peripheral
mbed_official 87:085cde657901 1174 * @param hsc: usart handle
mbed_official 87:085cde657901 1175 * @retval None
mbed_official 87:085cde657901 1176 */
mbed_official 87:085cde657901 1177 static void SMARTCARD_SetConfig(SMARTCARD_HandleTypeDef *hsc)
mbed_official 87:085cde657901 1178 {
mbed_official 87:085cde657901 1179 uint32_t tmpreg = 0x00;
mbed_official 87:085cde657901 1180
mbed_official 87:085cde657901 1181 /* Check the parameters */
mbed_official 87:085cde657901 1182 assert_param(IS_SMARTCARD_INSTANCE(hsc->Instance));
mbed_official 87:085cde657901 1183 assert_param(IS_SMARTCARD_POLARITY(hsc->Init.CLKPolarity));
mbed_official 87:085cde657901 1184 assert_param(IS_SMARTCARD_PHASE(hsc->Init.CLKPhase));
mbed_official 87:085cde657901 1185 assert_param(IS_SMARTCARD_LASTBIT(hsc->Init.CLKLastBit));
mbed_official 87:085cde657901 1186 assert_param(IS_SMARTCARD_BAUDRATE(hsc->Init.BaudRate));
mbed_official 87:085cde657901 1187 assert_param(IS_SMARTCARD_WORD_LENGTH(hsc->Init.WordLength));
mbed_official 87:085cde657901 1188 assert_param(IS_SMARTCARD_STOPBITS(hsc->Init.StopBits));
mbed_official 87:085cde657901 1189 assert_param(IS_SMARTCARD_PARITY(hsc->Init.Parity));
mbed_official 87:085cde657901 1190 assert_param(IS_SMARTCARD_MODE(hsc->Init.Mode));
mbed_official 87:085cde657901 1191 assert_param(IS_SMARTCARD_NACK_STATE(hsc->Init.NACKState));
mbed_official 87:085cde657901 1192
mbed_official 87:085cde657901 1193 /* The LBCL, CPOL and CPHA bits have to be selected when both the transmitter and the
mbed_official 87:085cde657901 1194 receiver are disabled (TE=RE=0) to ensure that the clock pulses function correctly. */
mbed_official 87:085cde657901 1195 hsc->Instance->CR1 &= (uint32_t)~((uint32_t)(USART_CR1_TE | USART_CR1_RE));
mbed_official 87:085cde657901 1196
mbed_official 87:085cde657901 1197 /*---------------------------- USART CR2 Configuration ---------------------*/
mbed_official 87:085cde657901 1198 tmpreg = hsc->Instance->CR2;
mbed_official 87:085cde657901 1199 /* Clear CLKEN, CPOL, CPHA and LBCL bits */
mbed_official 87:085cde657901 1200 tmpreg &= (uint32_t)~((uint32_t)(USART_CR2_CPHA | USART_CR2_CPOL | USART_CR2_CLKEN | USART_CR2_LBCL));
mbed_official 87:085cde657901 1201 /* Configure the SMARTCARD Clock, CPOL, CPHA and LastBit -----------------------*/
mbed_official 87:085cde657901 1202 /* Set CPOL bit according to hsc->Init.CLKPolarity value */
mbed_official 87:085cde657901 1203 /* Set CPHA bit according to hsc->Init.CLKPhase value */
mbed_official 87:085cde657901 1204 /* Set LBCL bit according to hsc->Init.CLKLastBit value */
mbed_official 87:085cde657901 1205 /* Set Stop Bits: Set STOP[13:12] bits according to hsc->Init.StopBits value */
mbed_official 87:085cde657901 1206 tmpreg |= (uint32_t)(USART_CR2_CLKEN | hsc->Init.CLKPolarity |
mbed_official 87:085cde657901 1207 hsc->Init.CLKPhase| hsc->Init.CLKLastBit | hsc->Init.StopBits);
mbed_official 87:085cde657901 1208 /* Write to USART CR2 */
mbed_official 87:085cde657901 1209 hsc->Instance->CR2 = (uint32_t)tmpreg;
mbed_official 87:085cde657901 1210
mbed_official 87:085cde657901 1211 tmpreg = hsc->Instance->CR2;
mbed_official 87:085cde657901 1212
mbed_official 87:085cde657901 1213 /* Clear STOP[13:12] bits */
mbed_official 87:085cde657901 1214 tmpreg &= (uint32_t)~((uint32_t)USART_CR2_STOP);
mbed_official 87:085cde657901 1215
mbed_official 87:085cde657901 1216 /* Set Stop Bits: Set STOP[13:12] bits according to hsc->Init.StopBits value */
mbed_official 87:085cde657901 1217 tmpreg |= (uint32_t)(hsc->Init.StopBits);
mbed_official 87:085cde657901 1218
mbed_official 87:085cde657901 1219 /* Write to USART CR2 */
mbed_official 87:085cde657901 1220 hsc->Instance->CR2 = (uint32_t)tmpreg;
mbed_official 87:085cde657901 1221
mbed_official 87:085cde657901 1222 /*-------------------------- USART CR1 Configuration -----------------------*/
mbed_official 87:085cde657901 1223 tmpreg = hsc->Instance->CR1;
mbed_official 87:085cde657901 1224
mbed_official 87:085cde657901 1225 /* Clear M, PCE, PS, TE and RE bits */
mbed_official 87:085cde657901 1226 tmpreg &= (uint32_t)~((uint32_t)(USART_CR1_M | USART_CR1_PCE | USART_CR1_PS | USART_CR1_TE | \
mbed_official 87:085cde657901 1227 USART_CR1_RE));
mbed_official 87:085cde657901 1228
mbed_official 87:085cde657901 1229 /* Configure the SMARTCARD Word Length, Parity and mode:
mbed_official 87:085cde657901 1230 Set the M bits according to hsc->Init.WordLength value
mbed_official 87:085cde657901 1231 Set PCE and PS bits according to hsc->Init.Parity value
mbed_official 87:085cde657901 1232 Set TE and RE bits according to hsc->Init.Mode value */
mbed_official 87:085cde657901 1233 tmpreg |= (uint32_t)hsc->Init.WordLength | hsc->Init.Parity | hsc->Init.Mode;
mbed_official 87:085cde657901 1234
mbed_official 87:085cde657901 1235 /* Write to USART CR1 */
mbed_official 87:085cde657901 1236 hsc->Instance->CR1 = (uint32_t)tmpreg;
mbed_official 87:085cde657901 1237
mbed_official 87:085cde657901 1238 /*-------------------------- USART CR3 Configuration -----------------------*/
mbed_official 87:085cde657901 1239 /* Clear CTSE and RTSE bits */
mbed_official 87:085cde657901 1240 hsc->Instance->CR3 &= (uint32_t)~((uint32_t)(USART_CR3_RTSE | USART_CR3_CTSE));
mbed_official 87:085cde657901 1241
mbed_official 87:085cde657901 1242 /*-------------------------- USART BRR Configuration -----------------------*/
mbed_official 87:085cde657901 1243 if((hsc->Instance == USART1) || (hsc->Instance == USART6))
mbed_official 87:085cde657901 1244 {
mbed_official 87:085cde657901 1245 hsc->Instance->BRR = __SMARTCARD_BRR(HAL_RCC_GetPCLK2Freq(), hsc->Init.BaudRate);
mbed_official 87:085cde657901 1246 }
mbed_official 87:085cde657901 1247 else
mbed_official 87:085cde657901 1248 {
mbed_official 87:085cde657901 1249 hsc->Instance->BRR = __SMARTCARD_BRR(HAL_RCC_GetPCLK1Freq(), hsc->Init.BaudRate);
mbed_official 87:085cde657901 1250 }
mbed_official 87:085cde657901 1251 }
mbed_official 87:085cde657901 1252
mbed_official 87:085cde657901 1253 /**
mbed_official 87:085cde657901 1254 * @}
mbed_official 87:085cde657901 1255 */
mbed_official 87:085cde657901 1256
mbed_official 87:085cde657901 1257 #endif /* HAL_SMARTCARD_MODULE_ENABLED */
mbed_official 87:085cde657901 1258 /**
mbed_official 87:085cde657901 1259 * @}
mbed_official 87:085cde657901 1260 */
mbed_official 87:085cde657901 1261
mbed_official 87:085cde657901 1262 /**
mbed_official 87:085cde657901 1263 * @}
mbed_official 87:085cde657901 1264 */
mbed_official 87:085cde657901 1265
mbed_official 87:085cde657901 1266 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/