PHung Tung / SRC_STM32F7

SPKT

Dependents:   WAV

targets/cmsis/TARGET_STM/TARGET_STM32F7/stm32f7xx_hal_usart.c@0:e87aa4c49e95, 2019-06-04 (annotated)

Committer:
phungductung
Date:
Tue Jun 04 21:51:46 2019 +0000
Revision:
0:e87aa4c49e95
libray

Who changed what in which revision?

UserRevisionLine numberNew contents of line
phungductung 0:e87aa4c49e95 1 /**
phungductung 0:e87aa4c49e95 2 ******************************************************************************
phungductung 0:e87aa4c49e95 3 * @file stm32f7xx_hal_usart.c
phungductung 0:e87aa4c49e95 4 * @author MCD Application Team
phungductung 0:e87aa4c49e95 5 * @version V1.0.4
phungductung 0:e87aa4c49e95 6 * @date 09-December-2015
phungductung 0:e87aa4c49e95 7 * @brief USART HAL module driver.
phungductung 0:e87aa4c49e95 8 * This file provides firmware functions to manage the following
phungductung 0:e87aa4c49e95 9 * functionalities of the Universal Synchronous/Asynchronous Receiver Transmitter
phungductung 0:e87aa4c49e95 10 * Peripheral (USART).
phungductung 0:e87aa4c49e95 11 * + Initialization and de-initialization functions
phungductung 0:e87aa4c49e95 12 * + IO operation functions
phungductung 0:e87aa4c49e95 13 * + Peripheral Control functions
phungductung 0:e87aa4c49e95 14 *
phungductung 0:e87aa4c49e95 15 @verbatim
phungductung 0:e87aa4c49e95 16 ===============================================================================
phungductung 0:e87aa4c49e95 17 ##### How to use this driver #####
phungductung 0:e87aa4c49e95 18 ===============================================================================
phungductung 0:e87aa4c49e95 19 [..]
phungductung 0:e87aa4c49e95 20 The USART HAL driver can be used as follows:
phungductung 0:e87aa4c49e95 21
phungductung 0:e87aa4c49e95 22 (#) Declare a USART_HandleTypeDef handle structure.
phungductung 0:e87aa4c49e95 23 (#) Initialize the USART low level resources by implement the HAL_USART_MspInit ()API:
phungductung 0:e87aa4c49e95 24 (##) Enable the USARTx interface clock.
phungductung 0:e87aa4c49e95 25 (##) USART pins configuration:
phungductung 0:e87aa4c49e95 26 (+++) Enable the clock for the USART GPIOs.
phungductung 0:e87aa4c49e95 27 (+++) Configure these USART pins as alternate function pull-up.
phungductung 0:e87aa4c49e95 28 (##) NVIC configuration if you need to use interrupt process (HAL_USART_Transmit_IT(),
phungductung 0:e87aa4c49e95 29 HAL_USART_Receive_IT() and HAL_USART_TransmitReceive_IT() APIs):
phungductung 0:e87aa4c49e95 30 (+++) Configure the USARTx interrupt priority.
phungductung 0:e87aa4c49e95 31 (+++) Enable the NVIC USART IRQ handle.
phungductung 0:e87aa4c49e95 32 (+++) The specific USART interrupts (Transmission complete interrupt,
phungductung 0:e87aa4c49e95 33 RXNE interrupt and Error Interrupts) will be managed using the macros
phungductung 0:e87aa4c49e95 34 __HAL_USART_ENABLE_IT() and __HAL_USART_DISABLE_IT() inside the transmit and receive process.
phungductung 0:e87aa4c49e95 35 (##) DMA Configuration if you need to use DMA process (HAL_USART_Transmit_DMA()
phungductung 0:e87aa4c49e95 36 HAL_USART_Receive_IT() and HAL_USART_TransmitReceive_IT() APIs):
phungductung 0:e87aa4c49e95 37 (+++) Declare a DMA handle structure for the Tx/Rx stream.
phungductung 0:e87aa4c49e95 38 (+++) Enable the DMAx interface clock.
phungductung 0:e87aa4c49e95 39 (+++) Configure the declared DMA handle structure with the required Tx/Rx parameters.
phungductung 0:e87aa4c49e95 40 (+++) Configure the DMA Tx/Rx Stream.
phungductung 0:e87aa4c49e95 41 (+++) Associate the initialized DMA handle to the USART DMA Tx/Rx handle.
phungductung 0:e87aa4c49e95 42 (+++) Configure the priority and enable the NVIC for the transfer complete interrupt on the DMA Tx/Rx Stream.
phungductung 0:e87aa4c49e95 43
phungductung 0:e87aa4c49e95 44 (#) Program the Baud Rate, Word Length, Stop Bit, Parity, Hardware
phungductung 0:e87aa4c49e95 45 flow control and Mode(Receiver/Transmitter) in the husart Init structure.
phungductung 0:e87aa4c49e95 46
phungductung 0:e87aa4c49e95 47 (#) Initialize the USART registers by calling the HAL_USART_Init() API:
phungductung 0:e87aa4c49e95 48 (++) These API's configures also the low level Hardware (GPIO, CLOCK, CORTEX...etc)
phungductung 0:e87aa4c49e95 49 by calling the customed HAL_USART_MspInit(&husart) API.
phungductung 0:e87aa4c49e95 50
phungductung 0:e87aa4c49e95 51 @endverbatim
phungductung 0:e87aa4c49e95 52 ******************************************************************************
phungductung 0:e87aa4c49e95 53 * @attention
phungductung 0:e87aa4c49e95 54 *
phungductung 0:e87aa4c49e95 55 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
phungductung 0:e87aa4c49e95 56 *
phungductung 0:e87aa4c49e95 57 * Redistribution and use in source and binary forms, with or without modification,
phungductung 0:e87aa4c49e95 58 * are permitted provided that the following conditions are met:
phungductung 0:e87aa4c49e95 59 * 1. Redistributions of source code must retain the above copyright notice,
phungductung 0:e87aa4c49e95 60 * this list of conditions and the following disclaimer.
phungductung 0:e87aa4c49e95 61 * 2. Redistributions in binary form must reproduce the above copyright notice,
phungductung 0:e87aa4c49e95 62 * this list of conditions and the following disclaimer in the documentation
phungductung 0:e87aa4c49e95 63 * and/or other materials provided with the distribution.
phungductung 0:e87aa4c49e95 64 * 3. Neither the name of STMicroelectronics nor the names of its contributors
phungductung 0:e87aa4c49e95 65 * may be used to endorse or promote products derived from this software
phungductung 0:e87aa4c49e95 66 * without specific prior written permission.
phungductung 0:e87aa4c49e95 67 *
phungductung 0:e87aa4c49e95 68 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
phungductung 0:e87aa4c49e95 69 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
phungductung 0:e87aa4c49e95 70 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
phungductung 0:e87aa4c49e95 71 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
phungductung 0:e87aa4c49e95 72 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
phungductung 0:e87aa4c49e95 73 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
phungductung 0:e87aa4c49e95 74 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
phungductung 0:e87aa4c49e95 75 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
phungductung 0:e87aa4c49e95 76 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
phungductung 0:e87aa4c49e95 77 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
phungductung 0:e87aa4c49e95 78 *
phungductung 0:e87aa4c49e95 79 ******************************************************************************
phungductung 0:e87aa4c49e95 80 */
phungductung 0:e87aa4c49e95 81
phungductung 0:e87aa4c49e95 82 /* Includes ------------------------------------------------------------------*/
phungductung 0:e87aa4c49e95 83 #include "stm32f7xx_hal.h"
phungductung 0:e87aa4c49e95 84
phungductung 0:e87aa4c49e95 85 /** @addtogroup STM32F7xx_HAL_Driver
phungductung 0:e87aa4c49e95 86 * @{
phungductung 0:e87aa4c49e95 87 */
phungductung 0:e87aa4c49e95 88
phungductung 0:e87aa4c49e95 89 /** @defgroup USART USART
phungductung 0:e87aa4c49e95 90 * @brief HAL USART Synchronous module driver
phungductung 0:e87aa4c49e95 91 * @{
phungductung 0:e87aa4c49e95 92 */
phungductung 0:e87aa4c49e95 93
phungductung 0:e87aa4c49e95 94 #ifdef HAL_USART_MODULE_ENABLED
phungductung 0:e87aa4c49e95 95
phungductung 0:e87aa4c49e95 96 /* Private typedef -----------------------------------------------------------*/
phungductung 0:e87aa4c49e95 97 /* Private define ------------------------------------------------------------*/
phungductung 0:e87aa4c49e95 98 /** @addtogroup USART_Private_Constants
phungductung 0:e87aa4c49e95 99 * @{
phungductung 0:e87aa4c49e95 100 */
phungductung 0:e87aa4c49e95 101 #define DUMMY_DATA ((uint16_t) 0xFFFF)
phungductung 0:e87aa4c49e95 102 #define TEACK_REACK_TIMEOUT ((uint32_t) 1000)
phungductung 0:e87aa4c49e95 103 #define USART_CR1_FIELDS ((uint32_t)(USART_CR1_M | USART_CR1_PCE | USART_CR1_PS | \
phungductung 0:e87aa4c49e95 104 USART_CR1_TE | USART_CR1_RE | USART_CR1_OVER8))
phungductung 0:e87aa4c49e95 105 #define USART_CR2_FIELDS ((uint32_t)(USART_CR2_CPHA | USART_CR2_CPOL | \
phungductung 0:e87aa4c49e95 106 USART_CR2_CLKEN | USART_CR2_LBCL | USART_CR2_STOP))
phungductung 0:e87aa4c49e95 107 /**
phungductung 0:e87aa4c49e95 108 * @}
phungductung 0:e87aa4c49e95 109 */
phungductung 0:e87aa4c49e95 110 /* Private macro -------------------------------------------------------------*/
phungductung 0:e87aa4c49e95 111 /* Private variables ---------------------------------------------------------*/
phungductung 0:e87aa4c49e95 112 /* Private function prototypes -----------------------------------------------*/
phungductung 0:e87aa4c49e95 113 /* Private functions ---------------------------------------------------------*/
phungductung 0:e87aa4c49e95 114 /** @addtogroup USART_Private_Functions
phungductung 0:e87aa4c49e95 115 * @{
phungductung 0:e87aa4c49e95 116 */
phungductung 0:e87aa4c49e95 117 static void USART_DMATransmitCplt(DMA_HandleTypeDef *hdma);
phungductung 0:e87aa4c49e95 118 static void USART_DMAReceiveCplt(DMA_HandleTypeDef *hdma);
phungductung 0:e87aa4c49e95 119 static void USART_DMATxHalfCplt(DMA_HandleTypeDef *hdma);
phungductung 0:e87aa4c49e95 120 static void USART_DMARxHalfCplt(DMA_HandleTypeDef *hdma);
phungductung 0:e87aa4c49e95 121 static void USART_DMAError(DMA_HandleTypeDef *hdma);
phungductung 0:e87aa4c49e95 122 static HAL_StatusTypeDef USART_WaitOnFlagUntilTimeout(USART_HandleTypeDef *husart, uint32_t Flag, FlagStatus Status, uint32_t Timeout);
phungductung 0:e87aa4c49e95 123 static HAL_StatusTypeDef USART_SetConfig(USART_HandleTypeDef *husart);
phungductung 0:e87aa4c49e95 124 static HAL_StatusTypeDef USART_CheckIdleState(USART_HandleTypeDef *husart);
phungductung 0:e87aa4c49e95 125 static HAL_StatusTypeDef USART_Transmit_IT(USART_HandleTypeDef *husart);
phungductung 0:e87aa4c49e95 126 static HAL_StatusTypeDef USART_EndTransmit_IT(USART_HandleTypeDef *husart);
phungductung 0:e87aa4c49e95 127 static HAL_StatusTypeDef USART_Receive_IT(USART_HandleTypeDef *husart);
phungductung 0:e87aa4c49e95 128 static HAL_StatusTypeDef USART_TransmitReceive_IT(USART_HandleTypeDef *husart);
phungductung 0:e87aa4c49e95 129 /**
phungductung 0:e87aa4c49e95 130 * @}
phungductung 0:e87aa4c49e95 131 */
phungductung 0:e87aa4c49e95 132
phungductung 0:e87aa4c49e95 133 /* Exported functions --------------------------------------------------------*/
phungductung 0:e87aa4c49e95 134
phungductung 0:e87aa4c49e95 135 /** @defgroup USART_Exported_Functions USART Exported Functions
phungductung 0:e87aa4c49e95 136 * @{
phungductung 0:e87aa4c49e95 137 */
phungductung 0:e87aa4c49e95 138
phungductung 0:e87aa4c49e95 139 /** @defgroup USART_Exported_Functions_Group1 USART Initialization and de-initialization functions
phungductung 0:e87aa4c49e95 140 * @brief Initialization and Configuration functions
phungductung 0:e87aa4c49e95 141 *
phungductung 0:e87aa4c49e95 142 @verbatim
phungductung 0:e87aa4c49e95 143 ===============================================================================
phungductung 0:e87aa4c49e95 144 ##### Initialization and Configuration functions #####
phungductung 0:e87aa4c49e95 145 ===============================================================================
phungductung 0:e87aa4c49e95 146 [..]
phungductung 0:e87aa4c49e95 147 This subsection provides a set of functions allowing to initialize the USART
phungductung 0:e87aa4c49e95 148 in asynchronous and in synchronous modes.
phungductung 0:e87aa4c49e95 149 (+) For the asynchronous mode only these parameters can be configured:
phungductung 0:e87aa4c49e95 150 (++) Baud Rate
phungductung 0:e87aa4c49e95 151 (++) Word Length
phungductung 0:e87aa4c49e95 152 (++) Stop Bit
phungductung 0:e87aa4c49e95 153 (++) Parity: If the parity is enabled, then the MSB bit of the data written
phungductung 0:e87aa4c49e95 154 in the data register is transmitted but is changed by the parity bit.
phungductung 0:e87aa4c49e95 155 Depending on the frame length defined by the M1 and M0 bits (7-bit,
phungductung 0:e87aa4c49e95 156 8-bit or 9-bit), the possible USART frame formats are as listed in the
phungductung 0:e87aa4c49e95 157 following table:
phungductung 0:e87aa4c49e95 158
phungductung 0:e87aa4c49e95 159 (+++) +---------------------------------------------------------------+
phungductung 0:e87aa4c49e95 160 (+++) | M1M0 bits | PCE bit | USART frame |
phungductung 0:e87aa4c49e95 161 (+++) |-----------------------|---------------------------------------|
phungductung 0:e87aa4c49e95 162 (+++) | 10 | 0 | | SB | 7-bit data | STB | |
phungductung 0:e87aa4c49e95 163 (+++) |-----------|-----------|---------------------------------------|
phungductung 0:e87aa4c49e95 164 (+++) | 10 | 1 | | SB | 6-bit data | PB | STB | |
phungductung 0:e87aa4c49e95 165 (+++) +---------------------------------------------------------------+
phungductung 0:e87aa4c49e95 166
phungductung 0:e87aa4c49e95 167 (++) USART polarity
phungductung 0:e87aa4c49e95 168 (++) USART phase
phungductung 0:e87aa4c49e95 169 (++) USART LastBit
phungductung 0:e87aa4c49e95 170 (++) Receiver/transmitter modes
phungductung 0:e87aa4c49e95 171
phungductung 0:e87aa4c49e95 172 [..]
phungductung 0:e87aa4c49e95 173 The HAL_USART_Init() function follows the USART synchronous configuration
phungductung 0:e87aa4c49e95 174 procedure (details for the procedure are available in reference manual).
phungductung 0:e87aa4c49e95 175
phungductung 0:e87aa4c49e95 176 @endverbatim
phungductung 0:e87aa4c49e95 177 * @{
phungductung 0:e87aa4c49e95 178 */
phungductung 0:e87aa4c49e95 179
phungductung 0:e87aa4c49e95 180 /**
phungductung 0:e87aa4c49e95 181 * @brief Initializes the USART mode according to the specified
phungductung 0:e87aa4c49e95 182 * parameters in the USART_InitTypeDef and create the associated handle.
phungductung 0:e87aa4c49e95 183 * @param husart: USART handle
phungductung 0:e87aa4c49e95 184 * @retval HAL status
phungductung 0:e87aa4c49e95 185 */
phungductung 0:e87aa4c49e95 186 HAL_StatusTypeDef HAL_USART_Init(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 187 {
phungductung 0:e87aa4c49e95 188 /* Check the USART handle allocation */
phungductung 0:e87aa4c49e95 189 if(husart == NULL)
phungductung 0:e87aa4c49e95 190 {
phungductung 0:e87aa4c49e95 191 return HAL_ERROR;
phungductung 0:e87aa4c49e95 192 }
phungductung 0:e87aa4c49e95 193
phungductung 0:e87aa4c49e95 194 /* Check the parameters */
phungductung 0:e87aa4c49e95 195 assert_param(IS_USART_INSTANCE(husart->Instance));
phungductung 0:e87aa4c49e95 196
phungductung 0:e87aa4c49e95 197 if(husart->State == HAL_USART_STATE_RESET)
phungductung 0:e87aa4c49e95 198 {
phungductung 0:e87aa4c49e95 199 /* Allocate lock resource and initialize it */
phungductung 0:e87aa4c49e95 200 husart->Lock = HAL_UNLOCKED;
phungductung 0:e87aa4c49e95 201 /* Init the low level hardware : GPIO, CLOCK */
phungductung 0:e87aa4c49e95 202 HAL_USART_MspInit(husart);
phungductung 0:e87aa4c49e95 203 }
phungductung 0:e87aa4c49e95 204
phungductung 0:e87aa4c49e95 205 husart->State = HAL_USART_STATE_BUSY;
phungductung 0:e87aa4c49e95 206
phungductung 0:e87aa4c49e95 207 /* Disable the Peripheral */
phungductung 0:e87aa4c49e95 208 __HAL_USART_DISABLE(husart);
phungductung 0:e87aa4c49e95 209
phungductung 0:e87aa4c49e95 210 /* Set the Usart Communication parameters */
phungductung 0:e87aa4c49e95 211 if (USART_SetConfig(husart) == HAL_ERROR)
phungductung 0:e87aa4c49e95 212 {
phungductung 0:e87aa4c49e95 213 return HAL_ERROR;
phungductung 0:e87aa4c49e95 214 }
phungductung 0:e87aa4c49e95 215
phungductung 0:e87aa4c49e95 216 /* In Synchronous mode, the following bits must be kept cleared:
phungductung 0:e87aa4c49e95 217 - LINEN bit in the USART_CR2 register
phungductung 0:e87aa4c49e95 218 - HDSEL, SCEN and IREN bits in the USART_CR3 register.*/
phungductung 0:e87aa4c49e95 219 husart->Instance->CR2 &= ~USART_CR2_LINEN;
phungductung 0:e87aa4c49e95 220 husart->Instance->CR3 &= ~(USART_CR3_SCEN | USART_CR3_HDSEL | USART_CR3_IREN);
phungductung 0:e87aa4c49e95 221
phungductung 0:e87aa4c49e95 222 /* Enable the Peripheral */
phungductung 0:e87aa4c49e95 223 __HAL_USART_ENABLE(husart);
phungductung 0:e87aa4c49e95 224
phungductung 0:e87aa4c49e95 225 /* TEACK and/or REACK to check before moving husart->State to Ready */
phungductung 0:e87aa4c49e95 226 return (USART_CheckIdleState(husart));
phungductung 0:e87aa4c49e95 227 }
phungductung 0:e87aa4c49e95 228
phungductung 0:e87aa4c49e95 229 /**
phungductung 0:e87aa4c49e95 230 * @brief DeInitializes the USART peripheral
phungductung 0:e87aa4c49e95 231 * @param husart: USART handle
phungductung 0:e87aa4c49e95 232 * @retval HAL status
phungductung 0:e87aa4c49e95 233 */
phungductung 0:e87aa4c49e95 234 HAL_StatusTypeDef HAL_USART_DeInit(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 235 {
phungductung 0:e87aa4c49e95 236 /* Check the USART handle allocation */
phungductung 0:e87aa4c49e95 237 if(husart == NULL)
phungductung 0:e87aa4c49e95 238 {
phungductung 0:e87aa4c49e95 239 return HAL_ERROR;
phungductung 0:e87aa4c49e95 240 }
phungductung 0:e87aa4c49e95 241
phungductung 0:e87aa4c49e95 242 /* Check the parameters */
phungductung 0:e87aa4c49e95 243 assert_param(IS_USART_INSTANCE(husart->Instance));
phungductung 0:e87aa4c49e95 244
phungductung 0:e87aa4c49e95 245 husart->State = HAL_USART_STATE_BUSY;
phungductung 0:e87aa4c49e95 246
phungductung 0:e87aa4c49e95 247 husart->Instance->CR1 = 0x0;
phungductung 0:e87aa4c49e95 248 husart->Instance->CR2 = 0x0;
phungductung 0:e87aa4c49e95 249 husart->Instance->CR3 = 0x0;
phungductung 0:e87aa4c49e95 250
phungductung 0:e87aa4c49e95 251 /* DeInit the low level hardware */
phungductung 0:e87aa4c49e95 252 HAL_USART_MspDeInit(husart);
phungductung 0:e87aa4c49e95 253
phungductung 0:e87aa4c49e95 254 husart->ErrorCode = HAL_USART_ERROR_NONE;
phungductung 0:e87aa4c49e95 255 husart->State = HAL_USART_STATE_RESET;
phungductung 0:e87aa4c49e95 256
phungductung 0:e87aa4c49e95 257 /* Process Unlock */
phungductung 0:e87aa4c49e95 258 __HAL_UNLOCK(husart);
phungductung 0:e87aa4c49e95 259
phungductung 0:e87aa4c49e95 260 return HAL_OK;
phungductung 0:e87aa4c49e95 261 }
phungductung 0:e87aa4c49e95 262
phungductung 0:e87aa4c49e95 263 /**
phungductung 0:e87aa4c49e95 264 * @brief USART MSP Init
phungductung 0:e87aa4c49e95 265 * @param husart: USART handle
phungductung 0:e87aa4c49e95 266 * @retval None
phungductung 0:e87aa4c49e95 267 */
phungductung 0:e87aa4c49e95 268 __weak void HAL_USART_MspInit(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 269 {
phungductung 0:e87aa4c49e95 270 /* Prevent unused argument(s) compilation warning */
phungductung 0:e87aa4c49e95 271 UNUSED(husart);
phungductung 0:e87aa4c49e95 272
phungductung 0:e87aa4c49e95 273 /* NOTE : This function should not be modified, when the callback is needed,
phungductung 0:e87aa4c49e95 274 the HAL_USART_MspInit can be implemented in the user file
phungductung 0:e87aa4c49e95 275 */
phungductung 0:e87aa4c49e95 276 }
phungductung 0:e87aa4c49e95 277
phungductung 0:e87aa4c49e95 278 /**
phungductung 0:e87aa4c49e95 279 * @brief USART MSP DeInit
phungductung 0:e87aa4c49e95 280 * @param husart: USART handle
phungductung 0:e87aa4c49e95 281 * @retval None
phungductung 0:e87aa4c49e95 282 */
phungductung 0:e87aa4c49e95 283 __weak void HAL_USART_MspDeInit(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 284 {
phungductung 0:e87aa4c49e95 285 /* Prevent unused argument(s) compilation warning */
phungductung 0:e87aa4c49e95 286 UNUSED(husart);
phungductung 0:e87aa4c49e95 287
phungductung 0:e87aa4c49e95 288 /* NOTE : This function should not be modified, when the callback is needed,
phungductung 0:e87aa4c49e95 289 the HAL_USART_MspDeInit can be implemented in the user file
phungductung 0:e87aa4c49e95 290 */
phungductung 0:e87aa4c49e95 291 }
phungductung 0:e87aa4c49e95 292
phungductung 0:e87aa4c49e95 293 /**
phungductung 0:e87aa4c49e95 294 * @}
phungductung 0:e87aa4c49e95 295 */
phungductung 0:e87aa4c49e95 296
phungductung 0:e87aa4c49e95 297 /** @defgroup USART_Exported_Functions_Group2 IO operation functions
phungductung 0:e87aa4c49e95 298 * @brief USART Transmit and Receive functions
phungductung 0:e87aa4c49e95 299 *
phungductung 0:e87aa4c49e95 300 @verbatim
phungductung 0:e87aa4c49e95 301 ===============================================================================
phungductung 0:e87aa4c49e95 302 ##### IO operation functions #####
phungductung 0:e87aa4c49e95 303 ===============================================================================
phungductung 0:e87aa4c49e95 304 This subsection provides a set of functions allowing to manage the USART synchronous
phungductung 0:e87aa4c49e95 305 data transfers.
phungductung 0:e87aa4c49e95 306
phungductung 0:e87aa4c49e95 307 [..] The USART supports master mode only: it cannot receive or send data related to an input
phungductung 0:e87aa4c49e95 308 clock (SCLK is always an output).
phungductung 0:e87aa4c49e95 309
phungductung 0:e87aa4c49e95 310 (#) There are two mode of transfer:
phungductung 0:e87aa4c49e95 311 (++) Blocking mode: The communication is performed in polling mode.
phungductung 0:e87aa4c49e95 312 The HAL status of all data processing is returned by the same function
phungductung 0:e87aa4c49e95 313 after finishing transfer.
phungductung 0:e87aa4c49e95 314 (++) No-Blocking mode: The communication is performed using Interrupts
phungductung 0:e87aa4c49e95 315 or DMA, These API's return the HAL status.
phungductung 0:e87aa4c49e95 316 The end of the data processing will be indicated through the
phungductung 0:e87aa4c49e95 317 dedicated USART IRQ when using Interrupt mode or the DMA IRQ when
phungductung 0:e87aa4c49e95 318 using DMA mode.
phungductung 0:e87aa4c49e95 319 The HAL_USART_TxCpltCallback(), HAL_USART_RxCpltCallback() and HAL_USART_TxRxCpltCallback() user callbacks
phungductung 0:e87aa4c49e95 320 will be executed respectively at the end of the transmit or Receive process
phungductung 0:e87aa4c49e95 321 The HAL_USART_ErrorCallback()user callback will be executed when a communication error is detected
phungductung 0:e87aa4c49e95 322
phungductung 0:e87aa4c49e95 323 (#) Blocking mode API's are :
phungductung 0:e87aa4c49e95 324 (++) HAL_USART_Transmit()in simplex mode
phungductung 0:e87aa4c49e95 325 (++) HAL_USART_Receive() in full duplex receive only
phungductung 0:e87aa4c49e95 326 (++) HAL_USART_TransmitReceive() in full duplex mode
phungductung 0:e87aa4c49e95 327
phungductung 0:e87aa4c49e95 328 (#) Non-Blocking mode API's with Interrupt are :
phungductung 0:e87aa4c49e95 329 (++) HAL_USART_Transmit_IT()in simplex mode
phungductung 0:e87aa4c49e95 330 (++) HAL_USART_Receive_IT() in full duplex receive only
phungductung 0:e87aa4c49e95 331 (++) HAL_USART_TransmitReceive_IT()in full duplex mode
phungductung 0:e87aa4c49e95 332 (++) HAL_USART_IRQHandler()
phungductung 0:e87aa4c49e95 333
phungductung 0:e87aa4c49e95 334 (#) No-Blocking mode functions with DMA are :
phungductung 0:e87aa4c49e95 335 (++) HAL_USART_Transmit_DMA()in simplex mode
phungductung 0:e87aa4c49e95 336 (++) HAL_USART_Receive_DMA() in full duplex receive only
phungductung 0:e87aa4c49e95 337 (++) HAL_USART_TransmitReceive_DMA() in full duplex mode
phungductung 0:e87aa4c49e95 338 (++) HAL_USART_DMAPause()
phungductung 0:e87aa4c49e95 339 (++) HAL_USART_DMAResume()
phungductung 0:e87aa4c49e95 340 (++) HAL_USART_DMAStop()
phungductung 0:e87aa4c49e95 341
phungductung 0:e87aa4c49e95 342 (#) A set of Transfer Complete Callbacks are provided in No_Blocking mode:
phungductung 0:e87aa4c49e95 343 (++) HAL_USART_TxCpltCallback()
phungductung 0:e87aa4c49e95 344 (++) HAL_USART_RxCpltCallback()
phungductung 0:e87aa4c49e95 345 (++) HAL_USART_TxHalfCpltCallback()
phungductung 0:e87aa4c49e95 346 (++) HAL_USART_RxHalfCpltCallback()
phungductung 0:e87aa4c49e95 347 (++) HAL_USART_ErrorCallback()
phungductung 0:e87aa4c49e95 348 (++) HAL_USART_TxRxCpltCallback()
phungductung 0:e87aa4c49e95 349
phungductung 0:e87aa4c49e95 350 @endverbatim
phungductung 0:e87aa4c49e95 351 * @{
phungductung 0:e87aa4c49e95 352 */
phungductung 0:e87aa4c49e95 353
phungductung 0:e87aa4c49e95 354 /**
phungductung 0:e87aa4c49e95 355 * @brief Simplex Send an amount of data in blocking mode
phungductung 0:e87aa4c49e95 356 * @param husart: USART handle
phungductung 0:e87aa4c49e95 357 * @param pTxData: pointer to data buffer
phungductung 0:e87aa4c49e95 358 * @param Size: amount of data to be sent
phungductung 0:e87aa4c49e95 359 * @param Timeout : Timeout duration
phungductung 0:e87aa4c49e95 360 * @retval HAL status
phungductung 0:e87aa4c49e95 361 */
phungductung 0:e87aa4c49e95 362 HAL_StatusTypeDef HAL_USART_Transmit(USART_HandleTypeDef *husart, uint8_t *pTxData, uint16_t Size, uint32_t Timeout)
phungductung 0:e87aa4c49e95 363 {
phungductung 0:e87aa4c49e95 364 uint16_t* tmp;
phungductung 0:e87aa4c49e95 365
phungductung 0:e87aa4c49e95 366 if(husart->State == HAL_USART_STATE_READY)
phungductung 0:e87aa4c49e95 367 {
phungductung 0:e87aa4c49e95 368 if((pTxData == NULL) || (Size == 0))
phungductung 0:e87aa4c49e95 369 {
phungductung 0:e87aa4c49e95 370 return HAL_ERROR;
phungductung 0:e87aa4c49e95 371 }
phungductung 0:e87aa4c49e95 372
phungductung 0:e87aa4c49e95 373 /* Process Locked */
phungductung 0:e87aa4c49e95 374 __HAL_LOCK(husart);
phungductung 0:e87aa4c49e95 375
phungductung 0:e87aa4c49e95 376 husart->ErrorCode = HAL_USART_ERROR_NONE;
phungductung 0:e87aa4c49e95 377 husart->State = HAL_USART_STATE_BUSY_TX;
phungductung 0:e87aa4c49e95 378
phungductung 0:e87aa4c49e95 379 husart->TxXferSize = Size;
phungductung 0:e87aa4c49e95 380 husart->TxXferCount = Size;
phungductung 0:e87aa4c49e95 381
phungductung 0:e87aa4c49e95 382 /* Check the remaining data to be sent */
phungductung 0:e87aa4c49e95 383 while(husart->TxXferCount > 0)
phungductung 0:e87aa4c49e95 384 {
phungductung 0:e87aa4c49e95 385 husart->TxXferCount--;
phungductung 0:e87aa4c49e95 386 if(USART_WaitOnFlagUntilTimeout(husart, USART_FLAG_TC, RESET, Timeout) != HAL_OK)
phungductung 0:e87aa4c49e95 387 {
phungductung 0:e87aa4c49e95 388 return HAL_TIMEOUT;
phungductung 0:e87aa4c49e95 389 }
phungductung 0:e87aa4c49e95 390 if((husart->Init.WordLength == USART_WORDLENGTH_9B) && (husart->Init.Parity == USART_PARITY_NONE))
phungductung 0:e87aa4c49e95 391 {
phungductung 0:e87aa4c49e95 392 tmp = (uint16_t*) pTxData;
phungductung 0:e87aa4c49e95 393 husart->Instance->TDR = (*tmp & (uint16_t)0x01FF);
phungductung 0:e87aa4c49e95 394 pTxData += 2;
phungductung 0:e87aa4c49e95 395 }
phungductung 0:e87aa4c49e95 396 else
phungductung 0:e87aa4c49e95 397 {
phungductung 0:e87aa4c49e95 398 husart->Instance->TDR = (*pTxData++ & (uint8_t)0xFF);
phungductung 0:e87aa4c49e95 399 }
phungductung 0:e87aa4c49e95 400 }
phungductung 0:e87aa4c49e95 401
phungductung 0:e87aa4c49e95 402 if(USART_WaitOnFlagUntilTimeout(husart, USART_FLAG_TC, RESET, Timeout) != HAL_OK)
phungductung 0:e87aa4c49e95 403 {
phungductung 0:e87aa4c49e95 404 return HAL_TIMEOUT;
phungductung 0:e87aa4c49e95 405 }
phungductung 0:e87aa4c49e95 406
phungductung 0:e87aa4c49e95 407 husart->State = HAL_USART_STATE_READY;
phungductung 0:e87aa4c49e95 408
phungductung 0:e87aa4c49e95 409 /* Process Unlocked */
phungductung 0:e87aa4c49e95 410 __HAL_UNLOCK(husart);
phungductung 0:e87aa4c49e95 411
phungductung 0:e87aa4c49e95 412 return HAL_OK;
phungductung 0:e87aa4c49e95 413 }
phungductung 0:e87aa4c49e95 414 else
phungductung 0:e87aa4c49e95 415 {
phungductung 0:e87aa4c49e95 416 return HAL_BUSY;
phungductung 0:e87aa4c49e95 417 }
phungductung 0:e87aa4c49e95 418 }
phungductung 0:e87aa4c49e95 419
phungductung 0:e87aa4c49e95 420 /**
phungductung 0:e87aa4c49e95 421 * @brief Receive an amount of data in blocking mode
phungductung 0:e87aa4c49e95 422 * @note To receive synchronous data, dummy data are simultaneously transmitted
phungductung 0:e87aa4c49e95 423 * @param husart: USART handle
phungductung 0:e87aa4c49e95 424 * @param pRxData: pointer to data buffer
phungductung 0:e87aa4c49e95 425 * @param Size: amount of data to be received
phungductung 0:e87aa4c49e95 426 * @param Timeout : Timeout duration
phungductung 0:e87aa4c49e95 427 * @retval HAL status
phungductung 0:e87aa4c49e95 428 */
phungductung 0:e87aa4c49e95 429 HAL_StatusTypeDef HAL_USART_Receive(USART_HandleTypeDef *husart, uint8_t *pRxData, uint16_t Size, uint32_t Timeout)
phungductung 0:e87aa4c49e95 430 {
phungductung 0:e87aa4c49e95 431 uint16_t* tmp;
phungductung 0:e87aa4c49e95 432 uint16_t uhMask;
phungductung 0:e87aa4c49e95 433
phungductung 0:e87aa4c49e95 434 if(husart->State == HAL_USART_STATE_READY)
phungductung 0:e87aa4c49e95 435 {
phungductung 0:e87aa4c49e95 436 if((pRxData == NULL) || (Size == 0))
phungductung 0:e87aa4c49e95 437 {
phungductung 0:e87aa4c49e95 438 return HAL_ERROR;
phungductung 0:e87aa4c49e95 439 }
phungductung 0:e87aa4c49e95 440 /* Process Locked */
phungductung 0:e87aa4c49e95 441 __HAL_LOCK(husart);
phungductung 0:e87aa4c49e95 442
phungductung 0:e87aa4c49e95 443 husart->ErrorCode = HAL_USART_ERROR_NONE;
phungductung 0:e87aa4c49e95 444 husart->State = HAL_USART_STATE_BUSY_RX;
phungductung 0:e87aa4c49e95 445
phungductung 0:e87aa4c49e95 446 husart->RxXferSize = Size;
phungductung 0:e87aa4c49e95 447 husart->RxXferCount = Size;
phungductung 0:e87aa4c49e95 448
phungductung 0:e87aa4c49e95 449 /* Computation of USART mask to apply to RDR register */
phungductung 0:e87aa4c49e95 450 __HAL_USART_MASK_COMPUTATION(husart);
phungductung 0:e87aa4c49e95 451 uhMask = husart->Mask;
phungductung 0:e87aa4c49e95 452
phungductung 0:e87aa4c49e95 453 /* as long as data have to be received */
phungductung 0:e87aa4c49e95 454 while(husart->RxXferCount > 0)
phungductung 0:e87aa4c49e95 455 {
phungductung 0:e87aa4c49e95 456 husart->RxXferCount--;
phungductung 0:e87aa4c49e95 457
phungductung 0:e87aa4c49e95 458 /* Wait until TC flag is set to send dummy byte in order to generate the
phungductung 0:e87aa4c49e95 459 * clock for the slave to send data.
phungductung 0:e87aa4c49e95 460 * Whatever the frame length (7, 8 or 9-bit long), the same dummy value
phungductung 0:e87aa4c49e95 461 * can be written for all the cases. */
phungductung 0:e87aa4c49e95 462 if(USART_WaitOnFlagUntilTimeout(husart, USART_FLAG_TC, RESET, Timeout) != HAL_OK)
phungductung 0:e87aa4c49e95 463 {
phungductung 0:e87aa4c49e95 464 return HAL_TIMEOUT;
phungductung 0:e87aa4c49e95 465 }
phungductung 0:e87aa4c49e95 466 husart->Instance->TDR = (DUMMY_DATA & (uint16_t)0x0FF);
phungductung 0:e87aa4c49e95 467
phungductung 0:e87aa4c49e95 468 /* Wait for RXNE Flag */
phungductung 0:e87aa4c49e95 469 if(USART_WaitOnFlagUntilTimeout(husart, USART_FLAG_RXNE, RESET, Timeout) != HAL_OK)
phungductung 0:e87aa4c49e95 470 {
phungductung 0:e87aa4c49e95 471 return HAL_TIMEOUT;
phungductung 0:e87aa4c49e95 472 }
phungductung 0:e87aa4c49e95 473
phungductung 0:e87aa4c49e95 474 if((husart->Init.WordLength == USART_WORDLENGTH_9B) && (husart->Init.Parity == USART_PARITY_NONE))
phungductung 0:e87aa4c49e95 475 {
phungductung 0:e87aa4c49e95 476 tmp = (uint16_t*) pRxData ;
phungductung 0:e87aa4c49e95 477 *tmp = (uint16_t)(husart->Instance->RDR & uhMask);
phungductung 0:e87aa4c49e95 478 pRxData +=2;
phungductung 0:e87aa4c49e95 479 }
phungductung 0:e87aa4c49e95 480 else
phungductung 0:e87aa4c49e95 481 {
phungductung 0:e87aa4c49e95 482 *pRxData++ = (uint8_t)(husart->Instance->RDR & (uint8_t)uhMask);
phungductung 0:e87aa4c49e95 483 }
phungductung 0:e87aa4c49e95 484 }
phungductung 0:e87aa4c49e95 485
phungductung 0:e87aa4c49e95 486 husart->State = HAL_USART_STATE_READY;
phungductung 0:e87aa4c49e95 487
phungductung 0:e87aa4c49e95 488 /* Process Unlocked */
phungductung 0:e87aa4c49e95 489 __HAL_UNLOCK(husart);
phungductung 0:e87aa4c49e95 490
phungductung 0:e87aa4c49e95 491 return HAL_OK;
phungductung 0:e87aa4c49e95 492 }
phungductung 0:e87aa4c49e95 493 else
phungductung 0:e87aa4c49e95 494 {
phungductung 0:e87aa4c49e95 495 return HAL_BUSY;
phungductung 0:e87aa4c49e95 496 }
phungductung 0:e87aa4c49e95 497 }
phungductung 0:e87aa4c49e95 498
phungductung 0:e87aa4c49e95 499 /**
phungductung 0:e87aa4c49e95 500 * @brief Full-Duplex Send and Receive an amount of data in blocking mode
phungductung 0:e87aa4c49e95 501 * @param husart: USART handle
phungductung 0:e87aa4c49e95 502 * @param pTxData: pointer to TX data buffer
phungductung 0:e87aa4c49e95 503 * @param pRxData: pointer to RX data buffer
phungductung 0:e87aa4c49e95 504 * @param Size: amount of data to be sent (same amount to be received)
phungductung 0:e87aa4c49e95 505 * @param Timeout : Timeout duration
phungductung 0:e87aa4c49e95 506 * @retval HAL status
phungductung 0:e87aa4c49e95 507 */
phungductung 0:e87aa4c49e95 508 HAL_StatusTypeDef HAL_USART_TransmitReceive(USART_HandleTypeDef *husart, uint8_t *pTxData, uint8_t *pRxData, uint16_t Size, uint32_t Timeout)
phungductung 0:e87aa4c49e95 509 {
phungductung 0:e87aa4c49e95 510 uint16_t* tmp;
phungductung 0:e87aa4c49e95 511 uint16_t uhMask;
phungductung 0:e87aa4c49e95 512
phungductung 0:e87aa4c49e95 513 if(husart->State == HAL_USART_STATE_READY)
phungductung 0:e87aa4c49e95 514 {
phungductung 0:e87aa4c49e95 515 if((pTxData == NULL) || (pRxData == NULL) || (Size == 0))
phungductung 0:e87aa4c49e95 516 {
phungductung 0:e87aa4c49e95 517 return HAL_ERROR;
phungductung 0:e87aa4c49e95 518 }
phungductung 0:e87aa4c49e95 519 /* Process Locked */
phungductung 0:e87aa4c49e95 520 __HAL_LOCK(husart);
phungductung 0:e87aa4c49e95 521
phungductung 0:e87aa4c49e95 522 husart->ErrorCode = HAL_USART_ERROR_NONE;
phungductung 0:e87aa4c49e95 523 husart->State = HAL_USART_STATE_BUSY_RX;
phungductung 0:e87aa4c49e95 524
phungductung 0:e87aa4c49e95 525 husart->RxXferSize = Size;
phungductung 0:e87aa4c49e95 526 husart->TxXferSize = Size;
phungductung 0:e87aa4c49e95 527 husart->TxXferCount = Size;
phungductung 0:e87aa4c49e95 528 husart->RxXferCount = Size;
phungductung 0:e87aa4c49e95 529
phungductung 0:e87aa4c49e95 530 /* Computation of USART mask to apply to RDR register */
phungductung 0:e87aa4c49e95 531 __HAL_USART_MASK_COMPUTATION(husart);
phungductung 0:e87aa4c49e95 532 uhMask = husart->Mask;
phungductung 0:e87aa4c49e95 533
phungductung 0:e87aa4c49e95 534 /* Check the remain data to be sent */
phungductung 0:e87aa4c49e95 535 while(husart->TxXferCount > 0)
phungductung 0:e87aa4c49e95 536 {
phungductung 0:e87aa4c49e95 537 husart->TxXferCount--;
phungductung 0:e87aa4c49e95 538 husart->RxXferCount--;
phungductung 0:e87aa4c49e95 539
phungductung 0:e87aa4c49e95 540 /* Wait until TC flag is set to send data */
phungductung 0:e87aa4c49e95 541 if(USART_WaitOnFlagUntilTimeout(husart, USART_FLAG_TC, RESET, Timeout) != HAL_OK)
phungductung 0:e87aa4c49e95 542 {
phungductung 0:e87aa4c49e95 543 return HAL_TIMEOUT;
phungductung 0:e87aa4c49e95 544 }
phungductung 0:e87aa4c49e95 545 if((husart->Init.WordLength == USART_WORDLENGTH_9B) && (husart->Init.Parity == USART_PARITY_NONE))
phungductung 0:e87aa4c49e95 546 {
phungductung 0:e87aa4c49e95 547 tmp = (uint16_t*) pTxData;
phungductung 0:e87aa4c49e95 548 husart->Instance->TDR = (*tmp & uhMask);
phungductung 0:e87aa4c49e95 549 pTxData += 2;
phungductung 0:e87aa4c49e95 550 }
phungductung 0:e87aa4c49e95 551 else
phungductung 0:e87aa4c49e95 552 {
phungductung 0:e87aa4c49e95 553 husart->Instance->TDR = (*pTxData++ & (uint8_t)uhMask);
phungductung 0:e87aa4c49e95 554 }
phungductung 0:e87aa4c49e95 555
phungductung 0:e87aa4c49e95 556 /* Wait for RXNE Flag */
phungductung 0:e87aa4c49e95 557 if(USART_WaitOnFlagUntilTimeout(husart, USART_FLAG_RXNE, RESET, Timeout) != HAL_OK)
phungductung 0:e87aa4c49e95 558 {
phungductung 0:e87aa4c49e95 559 return HAL_TIMEOUT;
phungductung 0:e87aa4c49e95 560 }
phungductung 0:e87aa4c49e95 561
phungductung 0:e87aa4c49e95 562 if((husart->Init.WordLength == USART_WORDLENGTH_9B) && (husart->Init.Parity == USART_PARITY_NONE))
phungductung 0:e87aa4c49e95 563 {
phungductung 0:e87aa4c49e95 564 tmp = (uint16_t*) pRxData ;
phungductung 0:e87aa4c49e95 565 *tmp = (uint16_t)(husart->Instance->RDR & uhMask);
phungductung 0:e87aa4c49e95 566 pRxData +=2;
phungductung 0:e87aa4c49e95 567 }
phungductung 0:e87aa4c49e95 568 else
phungductung 0:e87aa4c49e95 569 {
phungductung 0:e87aa4c49e95 570 *pRxData++ = (uint8_t)(husart->Instance->RDR & (uint8_t)uhMask);
phungductung 0:e87aa4c49e95 571 }
phungductung 0:e87aa4c49e95 572 }
phungductung 0:e87aa4c49e95 573
phungductung 0:e87aa4c49e95 574 husart->State = HAL_USART_STATE_READY;
phungductung 0:e87aa4c49e95 575
phungductung 0:e87aa4c49e95 576 /* Process Unlocked */
phungductung 0:e87aa4c49e95 577 __HAL_UNLOCK(husart);
phungductung 0:e87aa4c49e95 578
phungductung 0:e87aa4c49e95 579 return HAL_OK;
phungductung 0:e87aa4c49e95 580 }
phungductung 0:e87aa4c49e95 581 else
phungductung 0:e87aa4c49e95 582 {
phungductung 0:e87aa4c49e95 583 return HAL_BUSY;
phungductung 0:e87aa4c49e95 584 }
phungductung 0:e87aa4c49e95 585 }
phungductung 0:e87aa4c49e95 586
phungductung 0:e87aa4c49e95 587 /**
phungductung 0:e87aa4c49e95 588 * @brief Send an amount of data in interrupt mode
phungductung 0:e87aa4c49e95 589 * @param husart: USART handle
phungductung 0:e87aa4c49e95 590 * @param pTxData: pointer to data buffer
phungductung 0:e87aa4c49e95 591 * @param Size: amount of data to be sent
phungductung 0:e87aa4c49e95 592 * @retval HAL status
phungductung 0:e87aa4c49e95 593 */
phungductung 0:e87aa4c49e95 594 HAL_StatusTypeDef HAL_USART_Transmit_IT(USART_HandleTypeDef *husart, uint8_t *pTxData, uint16_t Size)
phungductung 0:e87aa4c49e95 595 {
phungductung 0:e87aa4c49e95 596 if(husart->State == HAL_USART_STATE_READY)
phungductung 0:e87aa4c49e95 597 {
phungductung 0:e87aa4c49e95 598 if((pTxData == NULL ) || (Size == 0))
phungductung 0:e87aa4c49e95 599 {
phungductung 0:e87aa4c49e95 600 return HAL_ERROR;
phungductung 0:e87aa4c49e95 601 }
phungductung 0:e87aa4c49e95 602
phungductung 0:e87aa4c49e95 603 /* Process Locked */
phungductung 0:e87aa4c49e95 604 __HAL_LOCK(husart);
phungductung 0:e87aa4c49e95 605
phungductung 0:e87aa4c49e95 606 husart->pTxBuffPtr = pTxData;
phungductung 0:e87aa4c49e95 607 husart->TxXferSize = Size;
phungductung 0:e87aa4c49e95 608 husart->TxXferCount = Size;
phungductung 0:e87aa4c49e95 609
phungductung 0:e87aa4c49e95 610 husart->ErrorCode = HAL_USART_ERROR_NONE;
phungductung 0:e87aa4c49e95 611 husart->State = HAL_USART_STATE_BUSY_TX;
phungductung 0:e87aa4c49e95 612
phungductung 0:e87aa4c49e95 613 /* The USART Error Interrupts: (Frame error, noise error, overrun error)
phungductung 0:e87aa4c49e95 614 are not managed by the USART Transmit Process to avoid the overrun interrupt
phungductung 0:e87aa4c49e95 615 when the usart mode is configured for transmit and receive "USART_MODE_TX_RX"
phungductung 0:e87aa4c49e95 616 to benefit for the frame error and noise interrupts the usart mode should be
phungductung 0:e87aa4c49e95 617 configured only for transmit "USART_MODE_TX" */
phungductung 0:e87aa4c49e95 618
phungductung 0:e87aa4c49e95 619 /* Process Unlocked */
phungductung 0:e87aa4c49e95 620 __HAL_UNLOCK(husart);
phungductung 0:e87aa4c49e95 621
phungductung 0:e87aa4c49e95 622 /* Enable the USART Transmit Data Register Empty Interrupt */
phungductung 0:e87aa4c49e95 623 __HAL_USART_ENABLE_IT(husart, USART_IT_TXE);
phungductung 0:e87aa4c49e95 624
phungductung 0:e87aa4c49e95 625 return HAL_OK;
phungductung 0:e87aa4c49e95 626 }
phungductung 0:e87aa4c49e95 627 else
phungductung 0:e87aa4c49e95 628 {
phungductung 0:e87aa4c49e95 629 return HAL_BUSY;
phungductung 0:e87aa4c49e95 630 }
phungductung 0:e87aa4c49e95 631 }
phungductung 0:e87aa4c49e95 632
phungductung 0:e87aa4c49e95 633 /**
phungductung 0:e87aa4c49e95 634 * @brief Receive an amount of data in blocking mode
phungductung 0:e87aa4c49e95 635 * To receive synchronous data, dummy data are simultaneously transmitted
phungductung 0:e87aa4c49e95 636 * @param husart: USART handle
phungductung 0:e87aa4c49e95 637 * @param pRxData: pointer to data buffer
phungductung 0:e87aa4c49e95 638 * @param Size: amount of data to be received
phungductung 0:e87aa4c49e95 639 * @retval HAL status
phungductung 0:e87aa4c49e95 640 */
phungductung 0:e87aa4c49e95 641 HAL_StatusTypeDef HAL_USART_Receive_IT(USART_HandleTypeDef *husart, uint8_t *pRxData, uint16_t Size)
phungductung 0:e87aa4c49e95 642 {
phungductung 0:e87aa4c49e95 643 if(husart->State == HAL_USART_STATE_READY)
phungductung 0:e87aa4c49e95 644 {
phungductung 0:e87aa4c49e95 645 if((pRxData == NULL ) || (Size == 0))
phungductung 0:e87aa4c49e95 646 {
phungductung 0:e87aa4c49e95 647 return HAL_ERROR;
phungductung 0:e87aa4c49e95 648 }
phungductung 0:e87aa4c49e95 649 /* Process Locked */
phungductung 0:e87aa4c49e95 650 __HAL_LOCK(husart);
phungductung 0:e87aa4c49e95 651
phungductung 0:e87aa4c49e95 652 husart->pRxBuffPtr = pRxData;
phungductung 0:e87aa4c49e95 653 husart->RxXferSize = Size;
phungductung 0:e87aa4c49e95 654 husart->RxXferCount = Size;
phungductung 0:e87aa4c49e95 655
phungductung 0:e87aa4c49e95 656 __HAL_USART_MASK_COMPUTATION(husart);
phungductung 0:e87aa4c49e95 657
phungductung 0:e87aa4c49e95 658 husart->ErrorCode = HAL_USART_ERROR_NONE;
phungductung 0:e87aa4c49e95 659 husart->State = HAL_USART_STATE_BUSY_RX;
phungductung 0:e87aa4c49e95 660
phungductung 0:e87aa4c49e95 661 /* Enable the USART Parity Error Interrupt */
phungductung 0:e87aa4c49e95 662 __HAL_USART_ENABLE_IT(husart, USART_IT_PE);
phungductung 0:e87aa4c49e95 663
phungductung 0:e87aa4c49e95 664 /* Enable the USART Error Interrupt: (Frame error, noise error, overrun error) */
phungductung 0:e87aa4c49e95 665 __HAL_USART_ENABLE_IT(husart, USART_IT_ERR);
phungductung 0:e87aa4c49e95 666
phungductung 0:e87aa4c49e95 667 /* Enable the USART Data Register not empty Interrupt */
phungductung 0:e87aa4c49e95 668 __HAL_USART_ENABLE_IT(husart, USART_IT_RXNE);
phungductung 0:e87aa4c49e95 669
phungductung 0:e87aa4c49e95 670 /* Process Unlocked */
phungductung 0:e87aa4c49e95 671 __HAL_UNLOCK(husart);
phungductung 0:e87aa4c49e95 672
phungductung 0:e87aa4c49e95 673
phungductung 0:e87aa4c49e95 674 /* Send dummy byte in order to generate the clock for the Slave to send the next data */
phungductung 0:e87aa4c49e95 675 if(husart->Init.WordLength == USART_WORDLENGTH_9B)
phungductung 0:e87aa4c49e95 676 {
phungductung 0:e87aa4c49e95 677 husart->Instance->TDR = (DUMMY_DATA & (uint16_t)0x01FF);
phungductung 0:e87aa4c49e95 678 }
phungductung 0:e87aa4c49e95 679 else
phungductung 0:e87aa4c49e95 680 {
phungductung 0:e87aa4c49e95 681 husart->Instance->TDR = (DUMMY_DATA & (uint16_t)0x00FF);
phungductung 0:e87aa4c49e95 682 }
phungductung 0:e87aa4c49e95 683
phungductung 0:e87aa4c49e95 684 return HAL_OK;
phungductung 0:e87aa4c49e95 685 }
phungductung 0:e87aa4c49e95 686 else
phungductung 0:e87aa4c49e95 687 {
phungductung 0:e87aa4c49e95 688 return HAL_BUSY;
phungductung 0:e87aa4c49e95 689 }
phungductung 0:e87aa4c49e95 690 }
phungductung 0:e87aa4c49e95 691
phungductung 0:e87aa4c49e95 692 /**
phungductung 0:e87aa4c49e95 693 * @brief Full-Duplex Send and Receive an amount of data in interrupt mode
phungductung 0:e87aa4c49e95 694 * @param husart: USART handle
phungductung 0:e87aa4c49e95 695 * @param pTxData: pointer to TX data buffer
phungductung 0:e87aa4c49e95 696 * @param pRxData: pointer to RX data buffer
phungductung 0:e87aa4c49e95 697 * @param Size: amount of data to be sent (same amount to be received)
phungductung 0:e87aa4c49e95 698 * @retval HAL status
phungductung 0:e87aa4c49e95 699 */
phungductung 0:e87aa4c49e95 700 HAL_StatusTypeDef HAL_USART_TransmitReceive_IT(USART_HandleTypeDef *husart, uint8_t *pTxData, uint8_t *pRxData, uint16_t Size)
phungductung 0:e87aa4c49e95 701 {
phungductung 0:e87aa4c49e95 702
phungductung 0:e87aa4c49e95 703 if(husart->State == HAL_USART_STATE_READY)
phungductung 0:e87aa4c49e95 704 {
phungductung 0:e87aa4c49e95 705 if((pTxData == NULL) || (pRxData == NULL) || (Size == 0))
phungductung 0:e87aa4c49e95 706 {
phungductung 0:e87aa4c49e95 707 return HAL_ERROR;
phungductung 0:e87aa4c49e95 708 }
phungductung 0:e87aa4c49e95 709 /* Process Locked */
phungductung 0:e87aa4c49e95 710 __HAL_LOCK(husart);
phungductung 0:e87aa4c49e95 711
phungductung 0:e87aa4c49e95 712 husart->pRxBuffPtr = pRxData;
phungductung 0:e87aa4c49e95 713 husart->RxXferSize = Size;
phungductung 0:e87aa4c49e95 714 husart->RxXferCount = Size;
phungductung 0:e87aa4c49e95 715 husart->pTxBuffPtr = pTxData;
phungductung 0:e87aa4c49e95 716 husart->TxXferSize = Size;
phungductung 0:e87aa4c49e95 717 husart->TxXferCount = Size;
phungductung 0:e87aa4c49e95 718
phungductung 0:e87aa4c49e95 719 /* Computation of USART mask to apply to RDR register */
phungductung 0:e87aa4c49e95 720 __HAL_USART_MASK_COMPUTATION(husart);
phungductung 0:e87aa4c49e95 721
phungductung 0:e87aa4c49e95 722 husart->ErrorCode = HAL_USART_ERROR_NONE;
phungductung 0:e87aa4c49e95 723 husart->State = HAL_USART_STATE_BUSY_TX_RX;
phungductung 0:e87aa4c49e95 724
phungductung 0:e87aa4c49e95 725 /* Enable the USART Data Register not empty Interrupt */
phungductung 0:e87aa4c49e95 726 __HAL_USART_ENABLE_IT(husart, USART_IT_RXNE);
phungductung 0:e87aa4c49e95 727
phungductung 0:e87aa4c49e95 728 /* Enable the USART Parity Error Interrupt */
phungductung 0:e87aa4c49e95 729 __HAL_USART_ENABLE_IT(husart, USART_IT_PE);
phungductung 0:e87aa4c49e95 730
phungductung 0:e87aa4c49e95 731 /* Enable the USART Error Interrupt: (Frame error, noise error, overrun error) */
phungductung 0:e87aa4c49e95 732 __HAL_USART_ENABLE_IT(husart, USART_IT_ERR);
phungductung 0:e87aa4c49e95 733
phungductung 0:e87aa4c49e95 734 /* Process Unlocked */
phungductung 0:e87aa4c49e95 735 __HAL_UNLOCK(husart);
phungductung 0:e87aa4c49e95 736
phungductung 0:e87aa4c49e95 737 /* Enable the USART Transmit Data Register Empty Interrupt */
phungductung 0:e87aa4c49e95 738 __HAL_USART_ENABLE_IT(husart, USART_IT_TXE);
phungductung 0:e87aa4c49e95 739
phungductung 0:e87aa4c49e95 740 return HAL_OK;
phungductung 0:e87aa4c49e95 741 }
phungductung 0:e87aa4c49e95 742 else
phungductung 0:e87aa4c49e95 743 {
phungductung 0:e87aa4c49e95 744 return HAL_BUSY;
phungductung 0:e87aa4c49e95 745 }
phungductung 0:e87aa4c49e95 746
phungductung 0:e87aa4c49e95 747 }
phungductung 0:e87aa4c49e95 748
phungductung 0:e87aa4c49e95 749 /**
phungductung 0:e87aa4c49e95 750 * @brief Send an amount of data in DMA mode
phungductung 0:e87aa4c49e95 751 * @param husart: USART handle
phungductung 0:e87aa4c49e95 752 * @param pTxData: pointer to data buffer
phungductung 0:e87aa4c49e95 753 * @param Size: amount of data to be sent
phungductung 0:e87aa4c49e95 754 * @retval HAL status
phungductung 0:e87aa4c49e95 755 */
phungductung 0:e87aa4c49e95 756 HAL_StatusTypeDef HAL_USART_Transmit_DMA(USART_HandleTypeDef *husart, uint8_t *pTxData, uint16_t Size)
phungductung 0:e87aa4c49e95 757 {
phungductung 0:e87aa4c49e95 758 uint32_t *tmp;
phungductung 0:e87aa4c49e95 759
phungductung 0:e87aa4c49e95 760 if(husart->State == HAL_USART_STATE_READY)
phungductung 0:e87aa4c49e95 761 {
phungductung 0:e87aa4c49e95 762 if((pTxData == NULL ) || (Size == 0))
phungductung 0:e87aa4c49e95 763 {
phungductung 0:e87aa4c49e95 764 return HAL_ERROR;
phungductung 0:e87aa4c49e95 765 }
phungductung 0:e87aa4c49e95 766 /* Process Locked */
phungductung 0:e87aa4c49e95 767 __HAL_LOCK(husart);
phungductung 0:e87aa4c49e95 768
phungductung 0:e87aa4c49e95 769 husart->pTxBuffPtr = pTxData;
phungductung 0:e87aa4c49e95 770 husart->TxXferSize = Size;
phungductung 0:e87aa4c49e95 771 husart->TxXferCount = Size;
phungductung 0:e87aa4c49e95 772
phungductung 0:e87aa4c49e95 773 husart->ErrorCode = HAL_USART_ERROR_NONE;
phungductung 0:e87aa4c49e95 774 husart->State = HAL_USART_STATE_BUSY_TX;
phungductung 0:e87aa4c49e95 775
phungductung 0:e87aa4c49e95 776 /* Set the USART DMA transfer complete callback */
phungductung 0:e87aa4c49e95 777 husart->hdmatx->XferCpltCallback = USART_DMATransmitCplt;
phungductung 0:e87aa4c49e95 778
phungductung 0:e87aa4c49e95 779 /* Set the USART DMA Half transfer complete callback */
phungductung 0:e87aa4c49e95 780 husart->hdmatx->XferHalfCpltCallback = USART_DMATxHalfCplt;
phungductung 0:e87aa4c49e95 781
phungductung 0:e87aa4c49e95 782 /* Set the DMA error callback */
phungductung 0:e87aa4c49e95 783 husart->hdmatx->XferErrorCallback = USART_DMAError;
phungductung 0:e87aa4c49e95 784
phungductung 0:e87aa4c49e95 785 /* Enable the USART transmit DMA channel */
phungductung 0:e87aa4c49e95 786 tmp = (uint32_t*)&pTxData;
phungductung 0:e87aa4c49e95 787 HAL_DMA_Start_IT(husart->hdmatx, *(uint32_t*)tmp, (uint32_t)&husart->Instance->TDR, Size);
phungductung 0:e87aa4c49e95 788
phungductung 0:e87aa4c49e95 789
phungductung 0:e87aa4c49e95 790 /* Clear the TC flag in the SR register by writing 0 to it */
phungductung 0:e87aa4c49e95 791 __HAL_USART_CLEAR_IT(husart, USART_FLAG_TC);
phungductung 0:e87aa4c49e95 792
phungductung 0:e87aa4c49e95 793 /* Enable the DMA transfer for transmit request by setting the DMAT bit
phungductung 0:e87aa4c49e95 794 in the USART CR3 register */
phungductung 0:e87aa4c49e95 795 husart->Instance->CR3 |= USART_CR3_DMAT;
phungductung 0:e87aa4c49e95 796
phungductung 0:e87aa4c49e95 797 /* Process Unlocked */
phungductung 0:e87aa4c49e95 798 __HAL_UNLOCK(husart);
phungductung 0:e87aa4c49e95 799
phungductung 0:e87aa4c49e95 800 return HAL_OK;
phungductung 0:e87aa4c49e95 801 }
phungductung 0:e87aa4c49e95 802 else
phungductung 0:e87aa4c49e95 803 {
phungductung 0:e87aa4c49e95 804 return HAL_BUSY;
phungductung 0:e87aa4c49e95 805 }
phungductung 0:e87aa4c49e95 806 }
phungductung 0:e87aa4c49e95 807
phungductung 0:e87aa4c49e95 808 /**
phungductung 0:e87aa4c49e95 809 * @brief Receive an amount of data in DMA mode
phungductung 0:e87aa4c49e95 810 * @param husart: USART handle
phungductung 0:e87aa4c49e95 811 * @param pRxData: pointer to data buffer
phungductung 0:e87aa4c49e95 812 * @param Size: amount of data to be received
phungductung 0:e87aa4c49e95 813 * @note When the USART parity is enabled (PCE = 1), the received data contain
phungductung 0:e87aa4c49e95 814 * the parity bit (MSB position)
phungductung 0:e87aa4c49e95 815 * @retval HAL status
phungductung 0:e87aa4c49e95 816 * @note The USART DMA transmit stream must be configured in order to generate the clock for the slave.
phungductung 0:e87aa4c49e95 817 */
phungductung 0:e87aa4c49e95 818 HAL_StatusTypeDef HAL_USART_Receive_DMA(USART_HandleTypeDef *husart, uint8_t *pRxData, uint16_t Size)
phungductung 0:e87aa4c49e95 819 {
phungductung 0:e87aa4c49e95 820 uint32_t *tmp;
phungductung 0:e87aa4c49e95 821
phungductung 0:e87aa4c49e95 822 if(husart->State == HAL_USART_STATE_READY)
phungductung 0:e87aa4c49e95 823 {
phungductung 0:e87aa4c49e95 824 if((pRxData == NULL ) || (Size == 0))
phungductung 0:e87aa4c49e95 825 {
phungductung 0:e87aa4c49e95 826 return HAL_ERROR;
phungductung 0:e87aa4c49e95 827 }
phungductung 0:e87aa4c49e95 828
phungductung 0:e87aa4c49e95 829 /* Process Locked */
phungductung 0:e87aa4c49e95 830 __HAL_LOCK(husart);
phungductung 0:e87aa4c49e95 831
phungductung 0:e87aa4c49e95 832 husart->pRxBuffPtr = pRxData;
phungductung 0:e87aa4c49e95 833 husart->RxXferSize = Size;
phungductung 0:e87aa4c49e95 834 husart->pTxBuffPtr = pRxData;
phungductung 0:e87aa4c49e95 835 husart->TxXferSize = Size;
phungductung 0:e87aa4c49e95 836
phungductung 0:e87aa4c49e95 837 husart->ErrorCode = HAL_USART_ERROR_NONE;
phungductung 0:e87aa4c49e95 838 husart->State = HAL_USART_STATE_BUSY_RX;
phungductung 0:e87aa4c49e95 839
phungductung 0:e87aa4c49e95 840 /* Set the USART DMA Rx transfer complete callback */
phungductung 0:e87aa4c49e95 841 husart->hdmarx->XferCpltCallback = USART_DMAReceiveCplt;
phungductung 0:e87aa4c49e95 842
phungductung 0:e87aa4c49e95 843 /* Set the USART DMA Half transfer complete callback */
phungductung 0:e87aa4c49e95 844 husart->hdmarx->XferHalfCpltCallback = USART_DMARxHalfCplt;
phungductung 0:e87aa4c49e95 845
phungductung 0:e87aa4c49e95 846 /* Set the USART DMA Rx transfer error callback */
phungductung 0:e87aa4c49e95 847 husart->hdmarx->XferErrorCallback = USART_DMAError;
phungductung 0:e87aa4c49e95 848
phungductung 0:e87aa4c49e95 849 /* Enable the USART receive DMA channel */
phungductung 0:e87aa4c49e95 850 tmp = (uint32_t*)&pRxData;
phungductung 0:e87aa4c49e95 851 HAL_DMA_Start_IT(husart->hdmarx, (uint32_t)&husart->Instance->RDR, *(uint32_t*)tmp, Size);
phungductung 0:e87aa4c49e95 852
phungductung 0:e87aa4c49e95 853 /* Enable the USART transmit DMA channel: the transmit stream is used in order
phungductung 0:e87aa4c49e95 854 to generate in the non-blocking mode the clock to the slave device,
phungductung 0:e87aa4c49e95 855 this mode isn't a simplex receive mode but a full-duplex receive mode */
phungductung 0:e87aa4c49e95 856 tmp = (uint32_t*)&pRxData;
phungductung 0:e87aa4c49e95 857 HAL_DMA_Start_IT(husart->hdmatx, *(uint32_t*)tmp, (uint32_t)&husart->Instance->TDR, Size);
phungductung 0:e87aa4c49e95 858
phungductung 0:e87aa4c49e95 859 /* Enable the DMA transfer for the receiver request by setting the DMAR bit
phungductung 0:e87aa4c49e95 860 in the USART CR3 register */
phungductung 0:e87aa4c49e95 861 husart->Instance->CR3 |= USART_CR3_DMAR;
phungductung 0:e87aa4c49e95 862
phungductung 0:e87aa4c49e95 863 /* Enable the DMA transfer for transmit request by setting the DMAT bit
phungductung 0:e87aa4c49e95 864 in the USART CR3 register */
phungductung 0:e87aa4c49e95 865 husart->Instance->CR3 |= USART_CR3_DMAT;
phungductung 0:e87aa4c49e95 866
phungductung 0:e87aa4c49e95 867 /* Process Unlocked */
phungductung 0:e87aa4c49e95 868 __HAL_UNLOCK(husart);
phungductung 0:e87aa4c49e95 869
phungductung 0:e87aa4c49e95 870 return HAL_OK;
phungductung 0:e87aa4c49e95 871 }
phungductung 0:e87aa4c49e95 872 else
phungductung 0:e87aa4c49e95 873 {
phungductung 0:e87aa4c49e95 874 return HAL_BUSY;
phungductung 0:e87aa4c49e95 875 }
phungductung 0:e87aa4c49e95 876 }
phungductung 0:e87aa4c49e95 877
phungductung 0:e87aa4c49e95 878 /**
phungductung 0:e87aa4c49e95 879 * @brief Full-Duplex Transmit Receive an amount of data in non blocking mode
phungductung 0:e87aa4c49e95 880 * @param husart: USART handle
phungductung 0:e87aa4c49e95 881 * @param pTxData: pointer to TX data buffer
phungductung 0:e87aa4c49e95 882 * @param pRxData: pointer to RX data buffer
phungductung 0:e87aa4c49e95 883 * @param Size: amount of data to be received/sent
phungductung 0:e87aa4c49e95 884 * @note When the USART parity is enabled (PCE = 1) the data received contain the parity bit.
phungductung 0:e87aa4c49e95 885 * @retval HAL status
phungductung 0:e87aa4c49e95 886 */
phungductung 0:e87aa4c49e95 887 HAL_StatusTypeDef HAL_USART_TransmitReceive_DMA(USART_HandleTypeDef *husart, uint8_t *pTxData, uint8_t *pRxData, uint16_t Size)
phungductung 0:e87aa4c49e95 888 {
phungductung 0:e87aa4c49e95 889 uint32_t *tmp;
phungductung 0:e87aa4c49e95 890
phungductung 0:e87aa4c49e95 891 if(husart->State == HAL_USART_STATE_READY)
phungductung 0:e87aa4c49e95 892 {
phungductung 0:e87aa4c49e95 893 if((pTxData == NULL) || (pRxData == NULL) || (Size == 0))
phungductung 0:e87aa4c49e95 894 {
phungductung 0:e87aa4c49e95 895 return HAL_ERROR;
phungductung 0:e87aa4c49e95 896 }
phungductung 0:e87aa4c49e95 897 /* Process Locked */
phungductung 0:e87aa4c49e95 898 __HAL_LOCK(husart);
phungductung 0:e87aa4c49e95 899
phungductung 0:e87aa4c49e95 900 husart->pRxBuffPtr = pRxData;
phungductung 0:e87aa4c49e95 901 husart->RxXferSize = Size;
phungductung 0:e87aa4c49e95 902 husart->pTxBuffPtr = pTxData;
phungductung 0:e87aa4c49e95 903 husart->TxXferSize = Size;
phungductung 0:e87aa4c49e95 904
phungductung 0:e87aa4c49e95 905 husart->ErrorCode = HAL_USART_ERROR_NONE;
phungductung 0:e87aa4c49e95 906 husart->State = HAL_USART_STATE_BUSY_TX_RX;
phungductung 0:e87aa4c49e95 907
phungductung 0:e87aa4c49e95 908 /* Set the USART DMA Rx transfer complete callback */
phungductung 0:e87aa4c49e95 909 husart->hdmarx->XferCpltCallback = USART_DMAReceiveCplt;
phungductung 0:e87aa4c49e95 910
phungductung 0:e87aa4c49e95 911 /* Set the USART DMA Half transfer complete callback */
phungductung 0:e87aa4c49e95 912 husart->hdmarx->XferHalfCpltCallback = USART_DMARxHalfCplt;
phungductung 0:e87aa4c49e95 913
phungductung 0:e87aa4c49e95 914 /* Set the USART DMA Tx transfer complete callback */
phungductung 0:e87aa4c49e95 915 husart->hdmatx->XferCpltCallback = USART_DMATransmitCplt;
phungductung 0:e87aa4c49e95 916
phungductung 0:e87aa4c49e95 917 /* Set the USART DMA Half transfer complete callback */
phungductung 0:e87aa4c49e95 918 husart->hdmatx->XferHalfCpltCallback = USART_DMATxHalfCplt;
phungductung 0:e87aa4c49e95 919
phungductung 0:e87aa4c49e95 920 /* Set the USART DMA Tx transfer error callback */
phungductung 0:e87aa4c49e95 921 husart->hdmatx->XferErrorCallback = USART_DMAError;
phungductung 0:e87aa4c49e95 922
phungductung 0:e87aa4c49e95 923 /* Set the USART DMA Rx transfer error callback */
phungductung 0:e87aa4c49e95 924 husart->hdmarx->XferErrorCallback = USART_DMAError;
phungductung 0:e87aa4c49e95 925
phungductung 0:e87aa4c49e95 926 /* Enable the USART receive DMA channel */
phungductung 0:e87aa4c49e95 927 tmp = (uint32_t*)&pRxData;
phungductung 0:e87aa4c49e95 928 HAL_DMA_Start_IT(husart->hdmarx, (uint32_t)&husart->Instance->RDR, *(uint32_t*)tmp, Size);
phungductung 0:e87aa4c49e95 929
phungductung 0:e87aa4c49e95 930 /* Enable the USART transmit DMA channel */
phungductung 0:e87aa4c49e95 931 tmp = (uint32_t*)&pTxData;
phungductung 0:e87aa4c49e95 932 HAL_DMA_Start_IT(husart->hdmatx, *(uint32_t*)tmp, (uint32_t)&husart->Instance->TDR, Size);
phungductung 0:e87aa4c49e95 933
phungductung 0:e87aa4c49e95 934 /* Clear the TC flag in the SR register by writing 0 to it */
phungductung 0:e87aa4c49e95 935 __HAL_USART_CLEAR_IT(husart, USART_FLAG_TC);
phungductung 0:e87aa4c49e95 936
phungductung 0:e87aa4c49e95 937 /* Enable the DMA transfer for the receiver request by setting the DMAR bit
phungductung 0:e87aa4c49e95 938 in the USART CR3 register */
phungductung 0:e87aa4c49e95 939 husart->Instance->CR3 |= USART_CR3_DMAR;
phungductung 0:e87aa4c49e95 940
phungductung 0:e87aa4c49e95 941 /* Enable the DMA transfer for transmit request by setting the DMAT bit
phungductung 0:e87aa4c49e95 942 in the USART CR3 register */
phungductung 0:e87aa4c49e95 943 husart->Instance->CR3 |= USART_CR3_DMAT;
phungductung 0:e87aa4c49e95 944
phungductung 0:e87aa4c49e95 945 /* Process Unlocked */
phungductung 0:e87aa4c49e95 946 __HAL_UNLOCK(husart);
phungductung 0:e87aa4c49e95 947
phungductung 0:e87aa4c49e95 948 return HAL_OK;
phungductung 0:e87aa4c49e95 949 }
phungductung 0:e87aa4c49e95 950 else
phungductung 0:e87aa4c49e95 951 {
phungductung 0:e87aa4c49e95 952 return HAL_BUSY;
phungductung 0:e87aa4c49e95 953 }
phungductung 0:e87aa4c49e95 954 }
phungductung 0:e87aa4c49e95 955
phungductung 0:e87aa4c49e95 956 /**
phungductung 0:e87aa4c49e95 957 * @brief Pauses the DMA Transfer.
phungductung 0:e87aa4c49e95 958 * @param husart: USART handle
phungductung 0:e87aa4c49e95 959 * @retval None
phungductung 0:e87aa4c49e95 960 */
phungductung 0:e87aa4c49e95 961 HAL_StatusTypeDef HAL_USART_DMAPause(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 962 {
phungductung 0:e87aa4c49e95 963 /* Process Locked */
phungductung 0:e87aa4c49e95 964 __HAL_LOCK(husart);
phungductung 0:e87aa4c49e95 965
phungductung 0:e87aa4c49e95 966 if(husart->State == HAL_USART_STATE_BUSY_TX)
phungductung 0:e87aa4c49e95 967 {
phungductung 0:e87aa4c49e95 968 /* Disable the USART DMA Tx request */
phungductung 0:e87aa4c49e95 969 husart->Instance->CR3 &= (uint32_t)(~USART_CR3_DMAT);
phungductung 0:e87aa4c49e95 970 }
phungductung 0:e87aa4c49e95 971 else if(husart->State == HAL_USART_STATE_BUSY_RX)
phungductung 0:e87aa4c49e95 972 {
phungductung 0:e87aa4c49e95 973 /* Disable the USART DMA Rx request */
phungductung 0:e87aa4c49e95 974 husart->Instance->CR3 &= (uint32_t)(~USART_CR3_DMAR);
phungductung 0:e87aa4c49e95 975 }
phungductung 0:e87aa4c49e95 976 else if(husart->State == HAL_USART_STATE_BUSY_TX_RX)
phungductung 0:e87aa4c49e95 977 {
phungductung 0:e87aa4c49e95 978 /* Disable the USART DMA Tx request */
phungductung 0:e87aa4c49e95 979 husart->Instance->CR3 &= (uint32_t)(~USART_CR3_DMAT);
phungductung 0:e87aa4c49e95 980 /* Disable the USART DMA Rx request */
phungductung 0:e87aa4c49e95 981 husart->Instance->CR3 &= (uint32_t)(~USART_CR3_DMAR);
phungductung 0:e87aa4c49e95 982 }
phungductung 0:e87aa4c49e95 983
phungductung 0:e87aa4c49e95 984 /* Process Unlocked */
phungductung 0:e87aa4c49e95 985 __HAL_UNLOCK(husart);
phungductung 0:e87aa4c49e95 986
phungductung 0:e87aa4c49e95 987 return HAL_OK;
phungductung 0:e87aa4c49e95 988 }
phungductung 0:e87aa4c49e95 989
phungductung 0:e87aa4c49e95 990 /**
phungductung 0:e87aa4c49e95 991 * @brief Resumes the DMA Transfer.
phungductung 0:e87aa4c49e95 992 * @param husart: USART handle
phungductung 0:e87aa4c49e95 993 * @retval None
phungductung 0:e87aa4c49e95 994 */
phungductung 0:e87aa4c49e95 995 HAL_StatusTypeDef HAL_USART_DMAResume(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 996 {
phungductung 0:e87aa4c49e95 997 /* Process Locked */
phungductung 0:e87aa4c49e95 998 __HAL_LOCK(husart);
phungductung 0:e87aa4c49e95 999
phungductung 0:e87aa4c49e95 1000 if(husart->State == HAL_USART_STATE_BUSY_TX)
phungductung 0:e87aa4c49e95 1001 {
phungductung 0:e87aa4c49e95 1002 /* Enable the USART DMA Tx request */
phungductung 0:e87aa4c49e95 1003 husart->Instance->CR3 |= USART_CR3_DMAT;
phungductung 0:e87aa4c49e95 1004 }
phungductung 0:e87aa4c49e95 1005 else if(husart->State == HAL_USART_STATE_BUSY_RX)
phungductung 0:e87aa4c49e95 1006 {
phungductung 0:e87aa4c49e95 1007 /* Clear the Overrun flag before resuming the Rx transfer*/
phungductung 0:e87aa4c49e95 1008 __HAL_USART_CLEAR_IT(husart, USART_CLEAR_OREF);
phungductung 0:e87aa4c49e95 1009
phungductung 0:e87aa4c49e95 1010 /* Enable the USART DMA Rx request */
phungductung 0:e87aa4c49e95 1011 husart->Instance->CR3 |= USART_CR3_DMAR;
phungductung 0:e87aa4c49e95 1012 }
phungductung 0:e87aa4c49e95 1013 else if(husart->State == HAL_USART_STATE_BUSY_TX_RX)
phungductung 0:e87aa4c49e95 1014 {
phungductung 0:e87aa4c49e95 1015 /* Clear the Overrun flag before resuming the Rx transfer*/
phungductung 0:e87aa4c49e95 1016 __HAL_USART_CLEAR_IT(husart, USART_CLEAR_OREF);
phungductung 0:e87aa4c49e95 1017
phungductung 0:e87aa4c49e95 1018 /* Enable the USART DMA Rx request before the DMA Tx request */
phungductung 0:e87aa4c49e95 1019 husart->Instance->CR3 |= USART_CR3_DMAR;
phungductung 0:e87aa4c49e95 1020
phungductung 0:e87aa4c49e95 1021 /* Enable the USART DMA Tx request */
phungductung 0:e87aa4c49e95 1022 husart->Instance->CR3 |= USART_CR3_DMAT;
phungductung 0:e87aa4c49e95 1023 }
phungductung 0:e87aa4c49e95 1024
phungductung 0:e87aa4c49e95 1025 /* Process Unlocked */
phungductung 0:e87aa4c49e95 1026 __HAL_UNLOCK(husart);
phungductung 0:e87aa4c49e95 1027
phungductung 0:e87aa4c49e95 1028 return HAL_OK;
phungductung 0:e87aa4c49e95 1029 }
phungductung 0:e87aa4c49e95 1030
phungductung 0:e87aa4c49e95 1031 /**
phungductung 0:e87aa4c49e95 1032 * @brief Stops the DMA Transfer.
phungductung 0:e87aa4c49e95 1033 * @param husart: USART handle
phungductung 0:e87aa4c49e95 1034 * @retval None
phungductung 0:e87aa4c49e95 1035 */
phungductung 0:e87aa4c49e95 1036 HAL_StatusTypeDef HAL_USART_DMAStop(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 1037 {
phungductung 0:e87aa4c49e95 1038 /* The Lock is not implemented on this API to allow the user application
phungductung 0:e87aa4c49e95 1039 to call the HAL USART API under callbacks HAL_USART_TxCpltCallback() / HAL_USART_RxCpltCallback() /
phungductung 0:e87aa4c49e95 1040 HAL_USART_TxHalfCpltCallback / HAL_USART_RxHalfCpltCallback:
phungductung 0:e87aa4c49e95 1041 indeed, when HAL_DMA_Abort() API is called, the DMA TX/RX Transfer or Half Transfer complete
phungductung 0:e87aa4c49e95 1042 interrupt is generated if the DMA transfer interruption occurs at the middle or at the end of
phungductung 0:e87aa4c49e95 1043 the stream and the corresponding call back is executed. */
phungductung 0:e87aa4c49e95 1044
phungductung 0:e87aa4c49e95 1045 /* Disable the USART Tx/Rx DMA requests */
phungductung 0:e87aa4c49e95 1046 husart->Instance->CR3 &= ~USART_CR3_DMAT;
phungductung 0:e87aa4c49e95 1047 husart->Instance->CR3 &= ~USART_CR3_DMAR;
phungductung 0:e87aa4c49e95 1048
phungductung 0:e87aa4c49e95 1049 /* Abort the USART DMA tx Stream */
phungductung 0:e87aa4c49e95 1050 if(husart->hdmatx != NULL)
phungductung 0:e87aa4c49e95 1051 {
phungductung 0:e87aa4c49e95 1052 HAL_DMA_Abort(husart->hdmatx);
phungductung 0:e87aa4c49e95 1053 }
phungductung 0:e87aa4c49e95 1054 /* Abort the USART DMA rx Stream */
phungductung 0:e87aa4c49e95 1055 if(husart->hdmarx != NULL)
phungductung 0:e87aa4c49e95 1056 {
phungductung 0:e87aa4c49e95 1057 HAL_DMA_Abort(husart->hdmarx);
phungductung 0:e87aa4c49e95 1058 }
phungductung 0:e87aa4c49e95 1059
phungductung 0:e87aa4c49e95 1060 husart->State = HAL_USART_STATE_READY;
phungductung 0:e87aa4c49e95 1061
phungductung 0:e87aa4c49e95 1062 return HAL_OK;
phungductung 0:e87aa4c49e95 1063 }
phungductung 0:e87aa4c49e95 1064
phungductung 0:e87aa4c49e95 1065 /**
phungductung 0:e87aa4c49e95 1066 * @brief This function handles USART interrupt request.
phungductung 0:e87aa4c49e95 1067 * @param husart: USART handle
phungductung 0:e87aa4c49e95 1068 * @retval None
phungductung 0:e87aa4c49e95 1069 */
phungductung 0:e87aa4c49e95 1070 void HAL_USART_IRQHandler(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 1071 {
phungductung 0:e87aa4c49e95 1072
phungductung 0:e87aa4c49e95 1073 /* USART parity error interrupt occurred ------------------------------------*/
phungductung 0:e87aa4c49e95 1074 if((__HAL_USART_GET_IT(husart, USART_IT_PE) != RESET) && (__HAL_USART_GET_IT_SOURCE(husart, USART_IT_PE) != RESET))
phungductung 0:e87aa4c49e95 1075 {
phungductung 0:e87aa4c49e95 1076 __HAL_USART_CLEAR_IT(husart, USART_CLEAR_PEF);
phungductung 0:e87aa4c49e95 1077 husart->ErrorCode |= HAL_USART_ERROR_PE;
phungductung 0:e87aa4c49e95 1078 /* Set the USART state ready to be able to start again the process */
phungductung 0:e87aa4c49e95 1079 husart->State = HAL_USART_STATE_READY;
phungductung 0:e87aa4c49e95 1080 }
phungductung 0:e87aa4c49e95 1081
phungductung 0:e87aa4c49e95 1082 /* USART frame error interrupt occurred -------------------------------------*/
phungductung 0:e87aa4c49e95 1083 if((__HAL_USART_GET_IT(husart, USART_IT_FE) != RESET) && (__HAL_USART_GET_IT_SOURCE(husart, USART_IT_ERR) != RESET))
phungductung 0:e87aa4c49e95 1084 {
phungductung 0:e87aa4c49e95 1085 __HAL_USART_CLEAR_IT(husart, USART_CLEAR_FEF);
phungductung 0:e87aa4c49e95 1086 husart->ErrorCode |= HAL_USART_ERROR_FE;
phungductung 0:e87aa4c49e95 1087 /* Set the USART state ready to be able to start again the process */
phungductung 0:e87aa4c49e95 1088 husart->State = HAL_USART_STATE_READY;
phungductung 0:e87aa4c49e95 1089 }
phungductung 0:e87aa4c49e95 1090
phungductung 0:e87aa4c49e95 1091 /* USART noise error interrupt occurred -------------------------------------*/
phungductung 0:e87aa4c49e95 1092 if((__HAL_USART_GET_IT(husart, USART_IT_NE) != RESET) && (__HAL_USART_GET_IT_SOURCE(husart, USART_IT_ERR) != RESET))
phungductung 0:e87aa4c49e95 1093 {
phungductung 0:e87aa4c49e95 1094 __HAL_USART_CLEAR_IT(husart, USART_CLEAR_NEF);
phungductung 0:e87aa4c49e95 1095 husart->ErrorCode |= HAL_USART_ERROR_NE;
phungductung 0:e87aa4c49e95 1096 /* Set the USART state ready to be able to start again the process */
phungductung 0:e87aa4c49e95 1097 husart->State = HAL_USART_STATE_READY;
phungductung 0:e87aa4c49e95 1098 }
phungductung 0:e87aa4c49e95 1099
phungductung 0:e87aa4c49e95 1100 /* USART Over-Run interrupt occurred ----------------------------------------*/
phungductung 0:e87aa4c49e95 1101 if((__HAL_USART_GET_IT(husart, USART_IT_ORE) != RESET) && (__HAL_USART_GET_IT_SOURCE(husart, USART_IT_ERR) != RESET))
phungductung 0:e87aa4c49e95 1102 {
phungductung 0:e87aa4c49e95 1103 __HAL_USART_CLEAR_IT(husart, USART_CLEAR_OREF);
phungductung 0:e87aa4c49e95 1104 husart->ErrorCode |= HAL_USART_ERROR_ORE;
phungductung 0:e87aa4c49e95 1105 /* Set the USART state ready to be able to start again the process */
phungductung 0:e87aa4c49e95 1106 husart->State = HAL_USART_STATE_READY;
phungductung 0:e87aa4c49e95 1107 }
phungductung 0:e87aa4c49e95 1108
phungductung 0:e87aa4c49e95 1109 /* Call USART Error Call back function if need be --------------------------*/
phungductung 0:e87aa4c49e95 1110 if(husart->ErrorCode != HAL_USART_ERROR_NONE)
phungductung 0:e87aa4c49e95 1111 {
phungductung 0:e87aa4c49e95 1112 HAL_USART_ErrorCallback(husart);
phungductung 0:e87aa4c49e95 1113 }
phungductung 0:e87aa4c49e95 1114
phungductung 0:e87aa4c49e95 1115 /* USART in mode Receiver --------------------------------------------------*/
phungductung 0:e87aa4c49e95 1116 if((__HAL_USART_GET_IT(husart, USART_IT_RXNE) != RESET) && (__HAL_USART_GET_IT_SOURCE(husart, USART_IT_RXNE) != RESET))
phungductung 0:e87aa4c49e95 1117 {
phungductung 0:e87aa4c49e95 1118 if(husart->State == HAL_USART_STATE_BUSY_RX)
phungductung 0:e87aa4c49e95 1119 {
phungductung 0:e87aa4c49e95 1120 USART_Receive_IT(husart);
phungductung 0:e87aa4c49e95 1121 }
phungductung 0:e87aa4c49e95 1122 else
phungductung 0:e87aa4c49e95 1123 {
phungductung 0:e87aa4c49e95 1124 USART_TransmitReceive_IT(husart);
phungductung 0:e87aa4c49e95 1125 }
phungductung 0:e87aa4c49e95 1126 }
phungductung 0:e87aa4c49e95 1127
phungductung 0:e87aa4c49e95 1128 /* USART in mode Transmitter -----------------------------------------------*/
phungductung 0:e87aa4c49e95 1129 if((__HAL_USART_GET_IT(husart, USART_IT_TXE) != RESET) &&(__HAL_USART_GET_IT_SOURCE(husart, USART_IT_TXE) != RESET))
phungductung 0:e87aa4c49e95 1130 {
phungductung 0:e87aa4c49e95 1131 if(husart->State == HAL_USART_STATE_BUSY_TX)
phungductung 0:e87aa4c49e95 1132 {
phungductung 0:e87aa4c49e95 1133 USART_Transmit_IT(husart);
phungductung 0:e87aa4c49e95 1134 }
phungductung 0:e87aa4c49e95 1135 else
phungductung 0:e87aa4c49e95 1136 {
phungductung 0:e87aa4c49e95 1137 USART_TransmitReceive_IT(husart);
phungductung 0:e87aa4c49e95 1138 }
phungductung 0:e87aa4c49e95 1139 }
phungductung 0:e87aa4c49e95 1140
phungductung 0:e87aa4c49e95 1141 /* USART in mode Transmitter (transmission end) -----------------------------*/
phungductung 0:e87aa4c49e95 1142 if((__HAL_USART_GET_IT(husart, USART_IT_TC) != RESET) &&(__HAL_USART_GET_IT_SOURCE(husart, USART_IT_TC) != RESET))
phungductung 0:e87aa4c49e95 1143 {
phungductung 0:e87aa4c49e95 1144 USART_EndTransmit_IT(husart);
phungductung 0:e87aa4c49e95 1145 }
phungductung 0:e87aa4c49e95 1146
phungductung 0:e87aa4c49e95 1147 }
phungductung 0:e87aa4c49e95 1148
phungductung 0:e87aa4c49e95 1149 /**
phungductung 0:e87aa4c49e95 1150 * @brief Tx Transfer completed callbacks
phungductung 0:e87aa4c49e95 1151 * @param husart: USART handle
phungductung 0:e87aa4c49e95 1152 * @retval None
phungductung 0:e87aa4c49e95 1153 */
phungductung 0:e87aa4c49e95 1154 __weak void HAL_USART_TxCpltCallback(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 1155 {
phungductung 0:e87aa4c49e95 1156 /* Prevent unused argument(s) compilation warning */
phungductung 0:e87aa4c49e95 1157 UNUSED(husart);
phungductung 0:e87aa4c49e95 1158
phungductung 0:e87aa4c49e95 1159 /* NOTE : This function should not be modified, when the callback is needed,
phungductung 0:e87aa4c49e95 1160 the HAL_USART_TxCpltCallback can be implemented in the user file
phungductung 0:e87aa4c49e95 1161 */
phungductung 0:e87aa4c49e95 1162 }
phungductung 0:e87aa4c49e95 1163
phungductung 0:e87aa4c49e95 1164 /**
phungductung 0:e87aa4c49e95 1165 * @brief Tx Half Transfer completed callbacks.
phungductung 0:e87aa4c49e95 1166 * @param husart: USART handle
phungductung 0:e87aa4c49e95 1167 * @retval None
phungductung 0:e87aa4c49e95 1168 */
phungductung 0:e87aa4c49e95 1169 __weak void HAL_USART_TxHalfCpltCallback(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 1170 {
phungductung 0:e87aa4c49e95 1171 /* Prevent unused argument(s) compilation warning */
phungductung 0:e87aa4c49e95 1172 UNUSED(husart);
phungductung 0:e87aa4c49e95 1173
phungductung 0:e87aa4c49e95 1174 /* NOTE: This function should not be modified, when the callback is needed,
phungductung 0:e87aa4c49e95 1175 the HAL_USART_TxHalfCpltCallback can be implemented in the user file
phungductung 0:e87aa4c49e95 1176 */
phungductung 0:e87aa4c49e95 1177 }
phungductung 0:e87aa4c49e95 1178
phungductung 0:e87aa4c49e95 1179 /**
phungductung 0:e87aa4c49e95 1180 * @brief Rx Transfer completed callbacks.
phungductung 0:e87aa4c49e95 1181 * @param husart: USART handle
phungductung 0:e87aa4c49e95 1182 * @retval None
phungductung 0:e87aa4c49e95 1183 */
phungductung 0:e87aa4c49e95 1184 __weak void HAL_USART_RxCpltCallback(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 1185 {
phungductung 0:e87aa4c49e95 1186 /* Prevent unused argument(s) compilation warning */
phungductung 0:e87aa4c49e95 1187 UNUSED(husart);
phungductung 0:e87aa4c49e95 1188
phungductung 0:e87aa4c49e95 1189 /* NOTE: This function should not be modified, when the callback is needed,
phungductung 0:e87aa4c49e95 1190 the HAL_USART_RxCpltCallback can be implemented in the user file
phungductung 0:e87aa4c49e95 1191 */
phungductung 0:e87aa4c49e95 1192 }
phungductung 0:e87aa4c49e95 1193
phungductung 0:e87aa4c49e95 1194 /**
phungductung 0:e87aa4c49e95 1195 * @brief Rx Half Transfer completed callbacks
phungductung 0:e87aa4c49e95 1196 * @param husart: usart handle
phungductung 0:e87aa4c49e95 1197 * @retval None
phungductung 0:e87aa4c49e95 1198 */
phungductung 0:e87aa4c49e95 1199 __weak void HAL_USART_RxHalfCpltCallback(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 1200 {
phungductung 0:e87aa4c49e95 1201 /* Prevent unused argument(s) compilation warning */
phungductung 0:e87aa4c49e95 1202 UNUSED(husart);
phungductung 0:e87aa4c49e95 1203
phungductung 0:e87aa4c49e95 1204 /* NOTE : This function should not be modified, when the callback is needed,
phungductung 0:e87aa4c49e95 1205 the HAL_USART_RxHalfCpltCallback can be implemented in the user file
phungductung 0:e87aa4c49e95 1206 */
phungductung 0:e87aa4c49e95 1207 }
phungductung 0:e87aa4c49e95 1208
phungductung 0:e87aa4c49e95 1209 /**
phungductung 0:e87aa4c49e95 1210 * @brief Tx/Rx Transfers completed callback for the non-blocking process
phungductung 0:e87aa4c49e95 1211 * @param husart: USART handle
phungductung 0:e87aa4c49e95 1212 * @retval None
phungductung 0:e87aa4c49e95 1213 */
phungductung 0:e87aa4c49e95 1214 __weak void HAL_USART_TxRxCpltCallback(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 1215 {
phungductung 0:e87aa4c49e95 1216 /* Prevent unused argument(s) compilation warning */
phungductung 0:e87aa4c49e95 1217 UNUSED(husart);
phungductung 0:e87aa4c49e95 1218
phungductung 0:e87aa4c49e95 1219 /* NOTE : This function should not be modified, when the callback is needed,
phungductung 0:e87aa4c49e95 1220 the HAL_USART_TxRxCpltCallback can be implemented in the user file
phungductung 0:e87aa4c49e95 1221 */
phungductung 0:e87aa4c49e95 1222 }
phungductung 0:e87aa4c49e95 1223
phungductung 0:e87aa4c49e95 1224 /**
phungductung 0:e87aa4c49e95 1225 * @brief USART error callbacks
phungductung 0:e87aa4c49e95 1226 * @param husart: USART handle
phungductung 0:e87aa4c49e95 1227 * @retval None
phungductung 0:e87aa4c49e95 1228 */
phungductung 0:e87aa4c49e95 1229 __weak void HAL_USART_ErrorCallback(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 1230 {
phungductung 0:e87aa4c49e95 1231 /* Prevent unused argument(s) compilation warning */
phungductung 0:e87aa4c49e95 1232 UNUSED(husart);
phungductung 0:e87aa4c49e95 1233
phungductung 0:e87aa4c49e95 1234 /* NOTE : This function should not be modified, when the callback is needed,
phungductung 0:e87aa4c49e95 1235 the HAL_USART_ErrorCallback can be implemented in the user file
phungductung 0:e87aa4c49e95 1236 */
phungductung 0:e87aa4c49e95 1237 }
phungductung 0:e87aa4c49e95 1238
phungductung 0:e87aa4c49e95 1239 /**
phungductung 0:e87aa4c49e95 1240 * @}
phungductung 0:e87aa4c49e95 1241 */
phungductung 0:e87aa4c49e95 1242
phungductung 0:e87aa4c49e95 1243 /** @defgroup USART_Exported_Functions_Group3 Peripheral State and Errors functions
phungductung 0:e87aa4c49e95 1244 * @brief USART State and Errors functions
phungductung 0:e87aa4c49e95 1245 *
phungductung 0:e87aa4c49e95 1246 @verbatim
phungductung 0:e87aa4c49e95 1247 ==============================================================================
phungductung 0:e87aa4c49e95 1248 ##### Peripheral State and Errors functions #####
phungductung 0:e87aa4c49e95 1249 ==============================================================================
phungductung 0:e87aa4c49e95 1250 [..]
phungductung 0:e87aa4c49e95 1251 This subsection provides a set of functions allowing to return the State of
phungductung 0:e87aa4c49e95 1252 USART communication
phungductung 0:e87aa4c49e95 1253 process, return Peripheral Errors occurred during communication process
phungductung 0:e87aa4c49e95 1254 (+) HAL_USART_GetState() API can be helpful to check in run-time the state
phungductung 0:e87aa4c49e95 1255 of the USART peripheral.
phungductung 0:e87aa4c49e95 1256 (+) HAL_USART_GetError() check in run-time errors that could be occurred during
phungductung 0:e87aa4c49e95 1257 communication.
phungductung 0:e87aa4c49e95 1258 @endverbatim
phungductung 0:e87aa4c49e95 1259 * @{
phungductung 0:e87aa4c49e95 1260 */
phungductung 0:e87aa4c49e95 1261
phungductung 0:e87aa4c49e95 1262 /**
phungductung 0:e87aa4c49e95 1263 * @brief return the USART state
phungductung 0:e87aa4c49e95 1264 * @param husart: USART handle
phungductung 0:e87aa4c49e95 1265 * @retval HAL state
phungductung 0:e87aa4c49e95 1266 */
phungductung 0:e87aa4c49e95 1267 HAL_USART_StateTypeDef HAL_USART_GetState(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 1268 {
phungductung 0:e87aa4c49e95 1269 return husart->State;
phungductung 0:e87aa4c49e95 1270 }
phungductung 0:e87aa4c49e95 1271
phungductung 0:e87aa4c49e95 1272 /**
phungductung 0:e87aa4c49e95 1273 * @brief Return the USART error code
phungductung 0:e87aa4c49e95 1274 * @param husart : pointer to a USART_HandleTypeDef structure that contains
phungductung 0:e87aa4c49e95 1275 * the configuration information for the specified USART.
phungductung 0:e87aa4c49e95 1276 * @retval USART Error Code
phungductung 0:e87aa4c49e95 1277 */
phungductung 0:e87aa4c49e95 1278 uint32_t HAL_USART_GetError(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 1279 {
phungductung 0:e87aa4c49e95 1280 return husart->ErrorCode;
phungductung 0:e87aa4c49e95 1281 }
phungductung 0:e87aa4c49e95 1282
phungductung 0:e87aa4c49e95 1283 /**
phungductung 0:e87aa4c49e95 1284 * @}
phungductung 0:e87aa4c49e95 1285 */
phungductung 0:e87aa4c49e95 1286
phungductung 0:e87aa4c49e95 1287
phungductung 0:e87aa4c49e95 1288 /**
phungductung 0:e87aa4c49e95 1289 * @brief Simplex Send an amount of data in non-blocking mode.
phungductung 0:e87aa4c49e95 1290 * @note Function called under interruption only, once
phungductung 0:e87aa4c49e95 1291 * interruptions have been enabled by HAL_USART_Transmit_IT().
phungductung 0:e87aa4c49e95 1292 * @param husart: USART handle
phungductung 0:e87aa4c49e95 1293 * @retval HAL status
phungductung 0:e87aa4c49e95 1294 * @note The USART errors are not managed to avoid the overrun error.
phungductung 0:e87aa4c49e95 1295 */
phungductung 0:e87aa4c49e95 1296 static HAL_StatusTypeDef USART_Transmit_IT(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 1297 {
phungductung 0:e87aa4c49e95 1298 uint16_t* tmp;
phungductung 0:e87aa4c49e95 1299
phungductung 0:e87aa4c49e95 1300 if(husart->State == HAL_USART_STATE_BUSY_TX)
phungductung 0:e87aa4c49e95 1301 {
phungductung 0:e87aa4c49e95 1302
phungductung 0:e87aa4c49e95 1303 if(husart->TxXferCount == 0)
phungductung 0:e87aa4c49e95 1304 {
phungductung 0:e87aa4c49e95 1305 /* Disable the USART Transmit Complete Interrupt */
phungductung 0:e87aa4c49e95 1306 __HAL_USART_DISABLE_IT(husart, USART_IT_TXE);
phungductung 0:e87aa4c49e95 1307
phungductung 0:e87aa4c49e95 1308 /* Enable the USART Transmit Complete Interrupt */
phungductung 0:e87aa4c49e95 1309 __HAL_USART_ENABLE_IT(husart, USART_IT_TC);
phungductung 0:e87aa4c49e95 1310
phungductung 0:e87aa4c49e95 1311 return HAL_OK;
phungductung 0:e87aa4c49e95 1312 }
phungductung 0:e87aa4c49e95 1313 else
phungductung 0:e87aa4c49e95 1314 {
phungductung 0:e87aa4c49e95 1315 if((husart->Init.WordLength == USART_WORDLENGTH_9B) && (husart->Init.Parity == USART_PARITY_NONE))
phungductung 0:e87aa4c49e95 1316 {
phungductung 0:e87aa4c49e95 1317 tmp = (uint16_t*) husart->pTxBuffPtr;
phungductung 0:e87aa4c49e95 1318 husart->Instance->TDR = (*tmp & (uint16_t)0x01FF);
phungductung 0:e87aa4c49e95 1319 husart->pTxBuffPtr += 2;
phungductung 0:e87aa4c49e95 1320 }
phungductung 0:e87aa4c49e95 1321 else
phungductung 0:e87aa4c49e95 1322 {
phungductung 0:e87aa4c49e95 1323 husart->Instance->TDR = (uint8_t)(*husart->pTxBuffPtr++ & (uint8_t)0xFF);
phungductung 0:e87aa4c49e95 1324 }
phungductung 0:e87aa4c49e95 1325
phungductung 0:e87aa4c49e95 1326 husart->TxXferCount--;
phungductung 0:e87aa4c49e95 1327
phungductung 0:e87aa4c49e95 1328 return HAL_OK;
phungductung 0:e87aa4c49e95 1329 }
phungductung 0:e87aa4c49e95 1330 }
phungductung 0:e87aa4c49e95 1331 else
phungductung 0:e87aa4c49e95 1332 {
phungductung 0:e87aa4c49e95 1333 return HAL_BUSY;
phungductung 0:e87aa4c49e95 1334 }
phungductung 0:e87aa4c49e95 1335 }
phungductung 0:e87aa4c49e95 1336
phungductung 0:e87aa4c49e95 1337 /**
phungductung 0:e87aa4c49e95 1338 * @brief Wraps up transmission in non-blocking mode.
phungductung 0:e87aa4c49e95 1339 * @param husart: pointer to a USART_HandleTypeDef structure that contains
phungductung 0:e87aa4c49e95 1340 * the configuration information for the specified USART module.
phungductung 0:e87aa4c49e95 1341 * @retval HAL status
phungductung 0:e87aa4c49e95 1342 */
phungductung 0:e87aa4c49e95 1343 static HAL_StatusTypeDef USART_EndTransmit_IT(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 1344 {
phungductung 0:e87aa4c49e95 1345 /* Disable the USART Transmit Complete Interrupt */
phungductung 0:e87aa4c49e95 1346 __HAL_USART_DISABLE_IT(husart, USART_IT_TC);
phungductung 0:e87aa4c49e95 1347
phungductung 0:e87aa4c49e95 1348 /* Disable the USART Error Interrupt: (Frame error, noise error, overrun error) */
phungductung 0:e87aa4c49e95 1349 __HAL_USART_DISABLE_IT(husart, USART_IT_ERR);
phungductung 0:e87aa4c49e95 1350
phungductung 0:e87aa4c49e95 1351 husart->State = HAL_USART_STATE_READY;
phungductung 0:e87aa4c49e95 1352
phungductung 0:e87aa4c49e95 1353 HAL_USART_TxCpltCallback(husart);
phungductung 0:e87aa4c49e95 1354
phungductung 0:e87aa4c49e95 1355 return HAL_OK;
phungductung 0:e87aa4c49e95 1356 }
phungductung 0:e87aa4c49e95 1357
phungductung 0:e87aa4c49e95 1358 /**
phungductung 0:e87aa4c49e95 1359 * @brief Simplex Receive an amount of data in non-blocking mode.
phungductung 0:e87aa4c49e95 1360 * Function called under interruption only, once
phungductung 0:e87aa4c49e95 1361 * interruptions have been enabled by HAL_USART_Receive_IT()
phungductung 0:e87aa4c49e95 1362 * @param husart: USART handle
phungductung 0:e87aa4c49e95 1363 * @retval HAL status
phungductung 0:e87aa4c49e95 1364 */
phungductung 0:e87aa4c49e95 1365 static HAL_StatusTypeDef USART_Receive_IT(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 1366 {
phungductung 0:e87aa4c49e95 1367 uint16_t* tmp;
phungductung 0:e87aa4c49e95 1368 uint16_t uhMask = husart->Mask;
phungductung 0:e87aa4c49e95 1369
phungductung 0:e87aa4c49e95 1370 if(husart->State == HAL_USART_STATE_BUSY_RX)
phungductung 0:e87aa4c49e95 1371 {
phungductung 0:e87aa4c49e95 1372
phungductung 0:e87aa4c49e95 1373 if((husart->Init.WordLength == USART_WORDLENGTH_9B) && (husart->Init.Parity == USART_PARITY_NONE))
phungductung 0:e87aa4c49e95 1374 {
phungductung 0:e87aa4c49e95 1375 tmp = (uint16_t*) husart->pRxBuffPtr;
phungductung 0:e87aa4c49e95 1376 *tmp = (uint16_t)(husart->Instance->RDR & uhMask);
phungductung 0:e87aa4c49e95 1377 husart->pRxBuffPtr += 2;
phungductung 0:e87aa4c49e95 1378 }
phungductung 0:e87aa4c49e95 1379 else
phungductung 0:e87aa4c49e95 1380 {
phungductung 0:e87aa4c49e95 1381 *husart->pRxBuffPtr++ = (uint8_t)(husart->Instance->RDR & (uint8_t)uhMask);
phungductung 0:e87aa4c49e95 1382 }
phungductung 0:e87aa4c49e95 1383 /* Send dummy byte in order to generate the clock for the Slave to Send the next data */
phungductung 0:e87aa4c49e95 1384 husart->Instance->TDR = (DUMMY_DATA & (uint16_t)0x00FF);
phungductung 0:e87aa4c49e95 1385
phungductung 0:e87aa4c49e95 1386 if(--husart->RxXferCount == 0)
phungductung 0:e87aa4c49e95 1387 {
phungductung 0:e87aa4c49e95 1388 __HAL_USART_DISABLE_IT(husart, USART_IT_RXNE);
phungductung 0:e87aa4c49e95 1389
phungductung 0:e87aa4c49e95 1390 /* Disable the USART Parity Error Interrupt */
phungductung 0:e87aa4c49e95 1391 __HAL_USART_DISABLE_IT(husart, USART_IT_PE);
phungductung 0:e87aa4c49e95 1392
phungductung 0:e87aa4c49e95 1393 /* Disable the USART Error Interrupt: (Frame error, noise error, overrun error) */
phungductung 0:e87aa4c49e95 1394 __HAL_USART_DISABLE_IT(husart, USART_IT_ERR);
phungductung 0:e87aa4c49e95 1395
phungductung 0:e87aa4c49e95 1396 husart->State = HAL_USART_STATE_READY;
phungductung 0:e87aa4c49e95 1397
phungductung 0:e87aa4c49e95 1398 HAL_USART_RxCpltCallback(husart);
phungductung 0:e87aa4c49e95 1399
phungductung 0:e87aa4c49e95 1400 return HAL_OK;
phungductung 0:e87aa4c49e95 1401 }
phungductung 0:e87aa4c49e95 1402
phungductung 0:e87aa4c49e95 1403 return HAL_OK;
phungductung 0:e87aa4c49e95 1404 }
phungductung 0:e87aa4c49e95 1405 else
phungductung 0:e87aa4c49e95 1406 {
phungductung 0:e87aa4c49e95 1407 return HAL_BUSY;
phungductung 0:e87aa4c49e95 1408 }
phungductung 0:e87aa4c49e95 1409 }
phungductung 0:e87aa4c49e95 1410
phungductung 0:e87aa4c49e95 1411 /**
phungductung 0:e87aa4c49e95 1412 * @brief Full-Duplex Send receive an amount of data in full-duplex mode (non-blocking).
phungductung 0:e87aa4c49e95 1413 * Function called under interruption only, once
phungductung 0:e87aa4c49e95 1414 * interruptions have been enabled by HAL_USART_TransmitReceive_IT()
phungductung 0:e87aa4c49e95 1415 * @param husart: USART handle
phungductung 0:e87aa4c49e95 1416 * @retval HAL status
phungductung 0:e87aa4c49e95 1417 */
phungductung 0:e87aa4c49e95 1418 static HAL_StatusTypeDef USART_TransmitReceive_IT(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 1419 {
phungductung 0:e87aa4c49e95 1420 uint16_t* tmp;
phungductung 0:e87aa4c49e95 1421 uint16_t uhMask = husart->Mask;
phungductung 0:e87aa4c49e95 1422
phungductung 0:e87aa4c49e95 1423 if(husart->State == HAL_USART_STATE_BUSY_TX_RX)
phungductung 0:e87aa4c49e95 1424 {
phungductung 0:e87aa4c49e95 1425 if(husart->TxXferCount != 0x00)
phungductung 0:e87aa4c49e95 1426 {
phungductung 0:e87aa4c49e95 1427 if(__HAL_USART_GET_FLAG(husart, USART_FLAG_TXE) != RESET)
phungductung 0:e87aa4c49e95 1428 {
phungductung 0:e87aa4c49e95 1429 if((husart->Init.WordLength == USART_WORDLENGTH_9B) && (husart->Init.Parity == USART_PARITY_NONE))
phungductung 0:e87aa4c49e95 1430 {
phungductung 0:e87aa4c49e95 1431 tmp = (uint16_t*) husart->pTxBuffPtr;
phungductung 0:e87aa4c49e95 1432 husart->Instance->TDR = (uint16_t)(*tmp & uhMask);
phungductung 0:e87aa4c49e95 1433 husart->pTxBuffPtr += 2;
phungductung 0:e87aa4c49e95 1434 }
phungductung 0:e87aa4c49e95 1435 else
phungductung 0:e87aa4c49e95 1436 {
phungductung 0:e87aa4c49e95 1437 husart->Instance->TDR = (uint8_t)(*husart->pTxBuffPtr++ & (uint8_t)uhMask);
phungductung 0:e87aa4c49e95 1438 }
phungductung 0:e87aa4c49e95 1439 husart->TxXferCount--;
phungductung 0:e87aa4c49e95 1440
phungductung 0:e87aa4c49e95 1441 /* Check the latest data transmitted */
phungductung 0:e87aa4c49e95 1442 if(husart->TxXferCount == 0)
phungductung 0:e87aa4c49e95 1443 {
phungductung 0:e87aa4c49e95 1444 __HAL_USART_DISABLE_IT(husart, USART_IT_TXE);
phungductung 0:e87aa4c49e95 1445 }
phungductung 0:e87aa4c49e95 1446 }
phungductung 0:e87aa4c49e95 1447 }
phungductung 0:e87aa4c49e95 1448
phungductung 0:e87aa4c49e95 1449 if(husart->RxXferCount != 0x00)
phungductung 0:e87aa4c49e95 1450 {
phungductung 0:e87aa4c49e95 1451 if(__HAL_USART_GET_FLAG(husart, USART_FLAG_RXNE) != RESET)
phungductung 0:e87aa4c49e95 1452 {
phungductung 0:e87aa4c49e95 1453 if((husart->Init.WordLength == USART_WORDLENGTH_9B) && (husart->Init.Parity == USART_PARITY_NONE))
phungductung 0:e87aa4c49e95 1454 {
phungductung 0:e87aa4c49e95 1455 tmp = (uint16_t*) husart->pRxBuffPtr;
phungductung 0:e87aa4c49e95 1456 *tmp = (uint16_t)(husart->Instance->RDR & uhMask);
phungductung 0:e87aa4c49e95 1457 husart->pRxBuffPtr += 2;
phungductung 0:e87aa4c49e95 1458 }
phungductung 0:e87aa4c49e95 1459 else
phungductung 0:e87aa4c49e95 1460 {
phungductung 0:e87aa4c49e95 1461 *husart->pRxBuffPtr++ = (uint8_t)(husart->Instance->RDR & (uint8_t)uhMask);
phungductung 0:e87aa4c49e95 1462 }
phungductung 0:e87aa4c49e95 1463 husart->RxXferCount--;
phungductung 0:e87aa4c49e95 1464 }
phungductung 0:e87aa4c49e95 1465 }
phungductung 0:e87aa4c49e95 1466
phungductung 0:e87aa4c49e95 1467 /* Check the latest data received */
phungductung 0:e87aa4c49e95 1468 if(husart->RxXferCount == 0)
phungductung 0:e87aa4c49e95 1469 {
phungductung 0:e87aa4c49e95 1470 __HAL_USART_DISABLE_IT(husart, USART_IT_RXNE);
phungductung 0:e87aa4c49e95 1471
phungductung 0:e87aa4c49e95 1472 /* Disable the USART Parity Error Interrupt */
phungductung 0:e87aa4c49e95 1473 __HAL_USART_DISABLE_IT(husart, USART_IT_PE);
phungductung 0:e87aa4c49e95 1474
phungductung 0:e87aa4c49e95 1475 /* Disable the USART Error Interrupt: (Frame error, noise error, overrun error) */
phungductung 0:e87aa4c49e95 1476 __HAL_USART_DISABLE_IT(husart, USART_IT_ERR);
phungductung 0:e87aa4c49e95 1477
phungductung 0:e87aa4c49e95 1478 husart->State = HAL_USART_STATE_READY;
phungductung 0:e87aa4c49e95 1479
phungductung 0:e87aa4c49e95 1480 HAL_USART_TxRxCpltCallback(husart);
phungductung 0:e87aa4c49e95 1481
phungductung 0:e87aa4c49e95 1482 return HAL_OK;
phungductung 0:e87aa4c49e95 1483 }
phungductung 0:e87aa4c49e95 1484
phungductung 0:e87aa4c49e95 1485 return HAL_OK;
phungductung 0:e87aa4c49e95 1486 }
phungductung 0:e87aa4c49e95 1487 else
phungductung 0:e87aa4c49e95 1488 {
phungductung 0:e87aa4c49e95 1489 return HAL_BUSY;
phungductung 0:e87aa4c49e95 1490 }
phungductung 0:e87aa4c49e95 1491 }
phungductung 0:e87aa4c49e95 1492
phungductung 0:e87aa4c49e95 1493 /**
phungductung 0:e87aa4c49e95 1494 * @brief This function handles USART Communication Timeout.
phungductung 0:e87aa4c49e95 1495 * @param husart: USART handle
phungductung 0:e87aa4c49e95 1496 * @param Flag: specifies the USART flag to check.
phungductung 0:e87aa4c49e95 1497 * @param Status: The new Flag status (SET or RESET).
phungductung 0:e87aa4c49e95 1498 * @param Timeout: Timeout duration
phungductung 0:e87aa4c49e95 1499 * @retval HAL status
phungductung 0:e87aa4c49e95 1500 */
phungductung 0:e87aa4c49e95 1501 static HAL_StatusTypeDef USART_WaitOnFlagUntilTimeout(USART_HandleTypeDef *husart, uint32_t Flag, FlagStatus Status, uint32_t Timeout)
phungductung 0:e87aa4c49e95 1502 {
phungductung 0:e87aa4c49e95 1503 uint32_t tickstart = HAL_GetTick();
phungductung 0:e87aa4c49e95 1504
phungductung 0:e87aa4c49e95 1505 /* Wait until flag is set */
phungductung 0:e87aa4c49e95 1506 if(Status == RESET)
phungductung 0:e87aa4c49e95 1507 {
phungductung 0:e87aa4c49e95 1508 while(__HAL_USART_GET_FLAG(husart, Flag) == RESET)
phungductung 0:e87aa4c49e95 1509 {
phungductung 0:e87aa4c49e95 1510 /* Check for the Timeout */
phungductung 0:e87aa4c49e95 1511 if(Timeout != HAL_MAX_DELAY)
phungductung 0:e87aa4c49e95 1512 {
phungductung 0:e87aa4c49e95 1513 if((Timeout == 0)||((HAL_GetTick()-tickstart) >= Timeout))
phungductung 0:e87aa4c49e95 1514 {
phungductung 0:e87aa4c49e95 1515 /* Disable TXE, RXNE, PE and ERR (Frame error, noise error, overrun error) interrupts for the interrupt process */
phungductung 0:e87aa4c49e95 1516 __HAL_USART_DISABLE_IT(husart, USART_IT_TXE);
phungductung 0:e87aa4c49e95 1517 __HAL_USART_DISABLE_IT(husart, USART_IT_RXNE);
phungductung 0:e87aa4c49e95 1518 __HAL_USART_DISABLE_IT(husart, USART_IT_PE);
phungductung 0:e87aa4c49e95 1519 __HAL_USART_DISABLE_IT(husart, USART_IT_ERR);
phungductung 0:e87aa4c49e95 1520
phungductung 0:e87aa4c49e95 1521 husart->State= HAL_USART_STATE_READY;
phungductung 0:e87aa4c49e95 1522
phungductung 0:e87aa4c49e95 1523 /* Process Unlocked */
phungductung 0:e87aa4c49e95 1524 __HAL_UNLOCK(husart);
phungductung 0:e87aa4c49e95 1525
phungductung 0:e87aa4c49e95 1526 return HAL_TIMEOUT;
phungductung 0:e87aa4c49e95 1527 }
phungductung 0:e87aa4c49e95 1528 }
phungductung 0:e87aa4c49e95 1529 }
phungductung 0:e87aa4c49e95 1530 }
phungductung 0:e87aa4c49e95 1531 else
phungductung 0:e87aa4c49e95 1532 {
phungductung 0:e87aa4c49e95 1533 while(__HAL_USART_GET_FLAG(husart, Flag) != RESET)
phungductung 0:e87aa4c49e95 1534 {
phungductung 0:e87aa4c49e95 1535 /* Check for the Timeout */
phungductung 0:e87aa4c49e95 1536 if(Timeout != HAL_MAX_DELAY)
phungductung 0:e87aa4c49e95 1537 {
phungductung 0:e87aa4c49e95 1538 if((Timeout == 0)||((HAL_GetTick()-tickstart) >= Timeout))
phungductung 0:e87aa4c49e95 1539 {
phungductung 0:e87aa4c49e95 1540 /* Disable TXE, RXNE, PE and ERR (Frame error, noise error, overrun error) interrupts for the interrupt process */
phungductung 0:e87aa4c49e95 1541 __HAL_USART_DISABLE_IT(husart, USART_IT_TXE);
phungductung 0:e87aa4c49e95 1542 __HAL_USART_DISABLE_IT(husart, USART_IT_RXNE);
phungductung 0:e87aa4c49e95 1543 __HAL_USART_DISABLE_IT(husart, USART_IT_PE);
phungductung 0:e87aa4c49e95 1544 __HAL_USART_DISABLE_IT(husart, USART_IT_ERR);
phungductung 0:e87aa4c49e95 1545
phungductung 0:e87aa4c49e95 1546 husart->State= HAL_USART_STATE_READY;
phungductung 0:e87aa4c49e95 1547
phungductung 0:e87aa4c49e95 1548 /* Process Unlocked */
phungductung 0:e87aa4c49e95 1549 __HAL_UNLOCK(husart);
phungductung 0:e87aa4c49e95 1550
phungductung 0:e87aa4c49e95 1551 return HAL_TIMEOUT;
phungductung 0:e87aa4c49e95 1552 }
phungductung 0:e87aa4c49e95 1553 }
phungductung 0:e87aa4c49e95 1554 }
phungductung 0:e87aa4c49e95 1555 }
phungductung 0:e87aa4c49e95 1556 return HAL_OK;
phungductung 0:e87aa4c49e95 1557 }
phungductung 0:e87aa4c49e95 1558
phungductung 0:e87aa4c49e95 1559
phungductung 0:e87aa4c49e95 1560 /**
phungductung 0:e87aa4c49e95 1561 * @brief DMA USART transmit process complete callback
phungductung 0:e87aa4c49e95 1562 * @param hdma: DMA handle
phungductung 0:e87aa4c49e95 1563 * @retval None
phungductung 0:e87aa4c49e95 1564 */
phungductung 0:e87aa4c49e95 1565 static void USART_DMATransmitCplt(DMA_HandleTypeDef *hdma)
phungductung 0:e87aa4c49e95 1566 {
phungductung 0:e87aa4c49e95 1567 USART_HandleTypeDef* husart = ( USART_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
phungductung 0:e87aa4c49e95 1568
phungductung 0:e87aa4c49e95 1569 /* DMA Normal mode */
phungductung 0:e87aa4c49e95 1570 if((hdma->Instance->CR & DMA_SxCR_CIRC) == 0)
phungductung 0:e87aa4c49e95 1571 {
phungductung 0:e87aa4c49e95 1572 husart->TxXferCount = 0;
phungductung 0:e87aa4c49e95 1573
phungductung 0:e87aa4c49e95 1574 if(husart->State == HAL_USART_STATE_BUSY_TX)
phungductung 0:e87aa4c49e95 1575 {
phungductung 0:e87aa4c49e95 1576 /* Disable the DMA transfer for transmit request by resetting the DMAT bit
phungductung 0:e87aa4c49e95 1577 in the USART CR3 register */
phungductung 0:e87aa4c49e95 1578 husart->Instance->CR3 &= ~(USART_CR3_DMAT);
phungductung 0:e87aa4c49e95 1579
phungductung 0:e87aa4c49e95 1580 /* Enable the USART Transmit Complete Interrupt */
phungductung 0:e87aa4c49e95 1581 __HAL_USART_ENABLE_IT(husart, USART_IT_TC);
phungductung 0:e87aa4c49e95 1582 }
phungductung 0:e87aa4c49e95 1583 }
phungductung 0:e87aa4c49e95 1584 /* DMA Circular mode */
phungductung 0:e87aa4c49e95 1585 else
phungductung 0:e87aa4c49e95 1586 {
phungductung 0:e87aa4c49e95 1587 if(husart->State == HAL_USART_STATE_BUSY_TX)
phungductung 0:e87aa4c49e95 1588 {
phungductung 0:e87aa4c49e95 1589 HAL_USART_TxCpltCallback(husart);
phungductung 0:e87aa4c49e95 1590 }
phungductung 0:e87aa4c49e95 1591 }
phungductung 0:e87aa4c49e95 1592 }
phungductung 0:e87aa4c49e95 1593
phungductung 0:e87aa4c49e95 1594
phungductung 0:e87aa4c49e95 1595 /**
phungductung 0:e87aa4c49e95 1596 * @brief DMA USART transmit process half complete callback
phungductung 0:e87aa4c49e95 1597 * @param hdma : DMA handle
phungductung 0:e87aa4c49e95 1598 * @retval None
phungductung 0:e87aa4c49e95 1599 */
phungductung 0:e87aa4c49e95 1600 static void USART_DMATxHalfCplt(DMA_HandleTypeDef *hdma)
phungductung 0:e87aa4c49e95 1601 {
phungductung 0:e87aa4c49e95 1602 USART_HandleTypeDef* husart = (USART_HandleTypeDef*)((DMA_HandleTypeDef*)hdma)->Parent;
phungductung 0:e87aa4c49e95 1603
phungductung 0:e87aa4c49e95 1604 HAL_USART_TxHalfCpltCallback(husart);
phungductung 0:e87aa4c49e95 1605 }
phungductung 0:e87aa4c49e95 1606
phungductung 0:e87aa4c49e95 1607 /**
phungductung 0:e87aa4c49e95 1608 * @brief DMA USART receive process complete callback
phungductung 0:e87aa4c49e95 1609 * @param hdma: DMA handle
phungductung 0:e87aa4c49e95 1610 * @retval None
phungductung 0:e87aa4c49e95 1611 */
phungductung 0:e87aa4c49e95 1612 static void USART_DMAReceiveCplt(DMA_HandleTypeDef *hdma)
phungductung 0:e87aa4c49e95 1613 {
phungductung 0:e87aa4c49e95 1614 USART_HandleTypeDef* husart = ( USART_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
phungductung 0:e87aa4c49e95 1615
phungductung 0:e87aa4c49e95 1616 /* DMA Normal mode */
phungductung 0:e87aa4c49e95 1617 if((hdma->Instance->CR & DMA_SxCR_CIRC) == 0)
phungductung 0:e87aa4c49e95 1618 {
phungductung 0:e87aa4c49e95 1619 husart->RxXferCount = 0;
phungductung 0:e87aa4c49e95 1620
phungductung 0:e87aa4c49e95 1621 /* Disable the DMA RX transfer for the receiver request by resetting the DMAR bit
phungductung 0:e87aa4c49e95 1622 in USART CR3 register */
phungductung 0:e87aa4c49e95 1623 husart->Instance->CR3 &= (uint32_t)~((uint32_t)USART_CR3_DMAR);
phungductung 0:e87aa4c49e95 1624 /* similarly, disable the DMA TX transfer that was started to provide the
phungductung 0:e87aa4c49e95 1625 clock to the slave device */
phungductung 0:e87aa4c49e95 1626 husart->Instance->CR3 &= (uint32_t)~((uint32_t)USART_CR3_DMAT);
phungductung 0:e87aa4c49e95 1627
phungductung 0:e87aa4c49e95 1628 if(husart->State == HAL_USART_STATE_BUSY_RX)
phungductung 0:e87aa4c49e95 1629 {
phungductung 0:e87aa4c49e95 1630 HAL_USART_RxCpltCallback(husart);
phungductung 0:e87aa4c49e95 1631 }
phungductung 0:e87aa4c49e95 1632 /* The USART state is HAL_USART_STATE_BUSY_TX_RX */
phungductung 0:e87aa4c49e95 1633 else
phungductung 0:e87aa4c49e95 1634 {
phungductung 0:e87aa4c49e95 1635 HAL_USART_TxRxCpltCallback(husart);
phungductung 0:e87aa4c49e95 1636 }
phungductung 0:e87aa4c49e95 1637 husart->State= HAL_USART_STATE_READY;
phungductung 0:e87aa4c49e95 1638 }
phungductung 0:e87aa4c49e95 1639 /* DMA circular mode */
phungductung 0:e87aa4c49e95 1640 else
phungductung 0:e87aa4c49e95 1641 {
phungductung 0:e87aa4c49e95 1642 if(husart->State == HAL_USART_STATE_BUSY_RX)
phungductung 0:e87aa4c49e95 1643 {
phungductung 0:e87aa4c49e95 1644 HAL_USART_RxCpltCallback(husart);
phungductung 0:e87aa4c49e95 1645 }
phungductung 0:e87aa4c49e95 1646 /* The USART state is HAL_USART_STATE_BUSY_TX_RX */
phungductung 0:e87aa4c49e95 1647 else
phungductung 0:e87aa4c49e95 1648 {
phungductung 0:e87aa4c49e95 1649 HAL_USART_TxRxCpltCallback(husart);
phungductung 0:e87aa4c49e95 1650 }
phungductung 0:e87aa4c49e95 1651 }
phungductung 0:e87aa4c49e95 1652 }
phungductung 0:e87aa4c49e95 1653
phungductung 0:e87aa4c49e95 1654 /**
phungductung 0:e87aa4c49e95 1655 * @brief DMA USART receive process half complete callback
phungductung 0:e87aa4c49e95 1656 * @param hdma : DMA handle
phungductung 0:e87aa4c49e95 1657 * @retval None
phungductung 0:e87aa4c49e95 1658 */
phungductung 0:e87aa4c49e95 1659 static void USART_DMARxHalfCplt(DMA_HandleTypeDef *hdma)
phungductung 0:e87aa4c49e95 1660 {
phungductung 0:e87aa4c49e95 1661 USART_HandleTypeDef* husart = (USART_HandleTypeDef*)((DMA_HandleTypeDef*)hdma)->Parent;
phungductung 0:e87aa4c49e95 1662
phungductung 0:e87aa4c49e95 1663 HAL_USART_RxHalfCpltCallback(husart);
phungductung 0:e87aa4c49e95 1664 }
phungductung 0:e87aa4c49e95 1665
phungductung 0:e87aa4c49e95 1666 /**
phungductung 0:e87aa4c49e95 1667 * @brief DMA USART communication error callback
phungductung 0:e87aa4c49e95 1668 * @param hdma: DMA handle
phungductung 0:e87aa4c49e95 1669 * @retval None
phungductung 0:e87aa4c49e95 1670 */
phungductung 0:e87aa4c49e95 1671 static void USART_DMAError(DMA_HandleTypeDef *hdma)
phungductung 0:e87aa4c49e95 1672 {
phungductung 0:e87aa4c49e95 1673 USART_HandleTypeDef* husart = ( USART_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
phungductung 0:e87aa4c49e95 1674
phungductung 0:e87aa4c49e95 1675 husart->RxXferCount = 0;
phungductung 0:e87aa4c49e95 1676 husart->TxXferCount = 0;
phungductung 0:e87aa4c49e95 1677 husart->ErrorCode |= HAL_USART_ERROR_DMA;
phungductung 0:e87aa4c49e95 1678 husart->State= HAL_USART_STATE_READY;
phungductung 0:e87aa4c49e95 1679
phungductung 0:e87aa4c49e95 1680 HAL_USART_ErrorCallback(husart);
phungductung 0:e87aa4c49e95 1681 }
phungductung 0:e87aa4c49e95 1682
phungductung 0:e87aa4c49e95 1683 /**
phungductung 0:e87aa4c49e95 1684 * @brief Configure the USART peripheral
phungductung 0:e87aa4c49e95 1685 * @param husart: USART handle
phungductung 0:e87aa4c49e95 1686 * @retval None
phungductung 0:e87aa4c49e95 1687 */
phungductung 0:e87aa4c49e95 1688 static HAL_StatusTypeDef USART_SetConfig(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 1689 {
phungductung 0:e87aa4c49e95 1690 uint32_t tmpreg = 0x0;
phungductung 0:e87aa4c49e95 1691 USART_ClockSourceTypeDef clocksource = USART_CLOCKSOURCE_UNDEFINED;
phungductung 0:e87aa4c49e95 1692 HAL_StatusTypeDef ret = HAL_OK;
phungductung 0:e87aa4c49e95 1693 uint16_t brrtemp = 0x0000;
phungductung 0:e87aa4c49e95 1694 uint16_t usartdiv = 0x0000;
phungductung 0:e87aa4c49e95 1695
phungductung 0:e87aa4c49e95 1696 /* Check the parameters */
phungductung 0:e87aa4c49e95 1697 assert_param(IS_USART_POLARITY(husart->Init.CLKPolarity));
phungductung 0:e87aa4c49e95 1698 assert_param(IS_USART_PHASE(husart->Init.CLKPhase));
phungductung 0:e87aa4c49e95 1699 assert_param(IS_USART_LASTBIT(husart->Init.CLKLastBit));
phungductung 0:e87aa4c49e95 1700 assert_param(IS_USART_BAUDRATE(husart->Init.BaudRate));
phungductung 0:e87aa4c49e95 1701 assert_param(IS_USART_WORD_LENGTH(husart->Init.WordLength));
phungductung 0:e87aa4c49e95 1702 assert_param(IS_USART_STOPBITS(husart->Init.StopBits));
phungductung 0:e87aa4c49e95 1703 assert_param(IS_USART_PARITY(husart->Init.Parity));
phungductung 0:e87aa4c49e95 1704 assert_param(IS_USART_MODE(husart->Init.Mode));
phungductung 0:e87aa4c49e95 1705 assert_param(IS_USART_OVERSAMPLING(husart->Init.OverSampling));
phungductung 0:e87aa4c49e95 1706
phungductung 0:e87aa4c49e95 1707
phungductung 0:e87aa4c49e95 1708 /*-------------------------- USART CR1 Configuration -----------------------*/
phungductung 0:e87aa4c49e95 1709 /* Clear M, PCE, PS, TE and RE bits and configure
phungductung 0:e87aa4c49e95 1710 * the USART Word Length, Parity, Mode and OverSampling:
phungductung 0:e87aa4c49e95 1711 * set the M bits according to husart->Init.WordLength value
phungductung 0:e87aa4c49e95 1712 * set PCE and PS bits according to husart->Init.Parity value
phungductung 0:e87aa4c49e95 1713 * set TE and RE bits according to husart->Init.Mode value
phungductung 0:e87aa4c49e95 1714 * force OVER8 to 1 to allow to reach the maximum speed (Fclock/8) */
phungductung 0:e87aa4c49e95 1715 tmpreg = (uint32_t)husart->Init.WordLength | husart->Init.Parity | husart->Init.Mode | USART_CR1_OVER8;
phungductung 0:e87aa4c49e95 1716 MODIFY_REG(husart->Instance->CR1, USART_CR1_FIELDS, tmpreg);
phungductung 0:e87aa4c49e95 1717
phungductung 0:e87aa4c49e95 1718 /*---------------------------- USART CR2 Configuration ---------------------*/
phungductung 0:e87aa4c49e95 1719 /* Clear and configure the USART Clock, CPOL, CPHA, LBCL and STOP bits:
phungductung 0:e87aa4c49e95 1720 * set CPOL bit according to husart->Init.CLKPolarity value
phungductung 0:e87aa4c49e95 1721 * set CPHA bit according to husart->Init.CLKPhase value
phungductung 0:e87aa4c49e95 1722 * set LBCL bit according to husart->Init.CLKLastBit value
phungductung 0:e87aa4c49e95 1723 * set STOP[13:12] bits according to husart->Init.StopBits value */
phungductung 0:e87aa4c49e95 1724 tmpreg = (uint32_t)(USART_CLOCK_ENABLE);
phungductung 0:e87aa4c49e95 1725 tmpreg |= ((uint32_t)husart->Init.CLKPolarity | (uint32_t)husart->Init.CLKPhase);
phungductung 0:e87aa4c49e95 1726 tmpreg |= ((uint32_t)husart->Init.CLKLastBit | (uint32_t)husart->Init.StopBits);
phungductung 0:e87aa4c49e95 1727 MODIFY_REG(husart->Instance->CR2, USART_CR2_FIELDS, tmpreg);
phungductung 0:e87aa4c49e95 1728
phungductung 0:e87aa4c49e95 1729 /*-------------------------- USART CR3 Configuration -----------------------*/
phungductung 0:e87aa4c49e95 1730 /* no CR3 register configuration */
phungductung 0:e87aa4c49e95 1731
phungductung 0:e87aa4c49e95 1732 /*-------------------------- USART BRR Configuration -----------------------*/
phungductung 0:e87aa4c49e95 1733 /* BRR is filled-up according to OVER8 bit setting which is forced to 1 */
phungductung 0:e87aa4c49e95 1734 USART_GETCLOCKSOURCE(husart, clocksource);
phungductung 0:e87aa4c49e95 1735 switch (clocksource)
phungductung 0:e87aa4c49e95 1736 {
phungductung 0:e87aa4c49e95 1737 case USART_CLOCKSOURCE_PCLK1:
phungductung 0:e87aa4c49e95 1738 usartdiv = (uint16_t)((2*HAL_RCC_GetPCLK1Freq()) / husart->Init.BaudRate);
phungductung 0:e87aa4c49e95 1739 break;
phungductung 0:e87aa4c49e95 1740 case USART_CLOCKSOURCE_PCLK2:
phungductung 0:e87aa4c49e95 1741 usartdiv = (uint16_t)((2*HAL_RCC_GetPCLK2Freq()) / husart->Init.BaudRate);
phungductung 0:e87aa4c49e95 1742 break;
phungductung 0:e87aa4c49e95 1743 case USART_CLOCKSOURCE_HSI:
phungductung 0:e87aa4c49e95 1744 usartdiv = (uint16_t)((2*HSI_VALUE) / husart->Init.BaudRate);
phungductung 0:e87aa4c49e95 1745 break;
phungductung 0:e87aa4c49e95 1746 case USART_CLOCKSOURCE_SYSCLK:
phungductung 0:e87aa4c49e95 1747 usartdiv = (uint16_t)((2*HAL_RCC_GetSysClockFreq()) / husart->Init.BaudRate);
phungductung 0:e87aa4c49e95 1748 break;
phungductung 0:e87aa4c49e95 1749 case USART_CLOCKSOURCE_LSE:
phungductung 0:e87aa4c49e95 1750 usartdiv = (uint16_t)((2*LSE_VALUE) / husart->Init.BaudRate);
phungductung 0:e87aa4c49e95 1751 break;
phungductung 0:e87aa4c49e95 1752 case USART_CLOCKSOURCE_UNDEFINED:
phungductung 0:e87aa4c49e95 1753 default:
phungductung 0:e87aa4c49e95 1754 ret = HAL_ERROR;
phungductung 0:e87aa4c49e95 1755 break;
phungductung 0:e87aa4c49e95 1756 }
phungductung 0:e87aa4c49e95 1757
phungductung 0:e87aa4c49e95 1758 brrtemp = usartdiv & 0xFFF0;
phungductung 0:e87aa4c49e95 1759 brrtemp |= (uint16_t)((usartdiv & (uint16_t)0x000F) >> 1U);
phungductung 0:e87aa4c49e95 1760 husart->Instance->BRR = brrtemp;
phungductung 0:e87aa4c49e95 1761
phungductung 0:e87aa4c49e95 1762 return ret;
phungductung 0:e87aa4c49e95 1763 }
phungductung 0:e87aa4c49e95 1764
phungductung 0:e87aa4c49e95 1765 /**
phungductung 0:e87aa4c49e95 1766 * @brief Check the USART Idle State
phungductung 0:e87aa4c49e95 1767 * @param husart: USART handle
phungductung 0:e87aa4c49e95 1768 * @retval HAL status
phungductung 0:e87aa4c49e95 1769 */
phungductung 0:e87aa4c49e95 1770 static HAL_StatusTypeDef USART_CheckIdleState(USART_HandleTypeDef *husart)
phungductung 0:e87aa4c49e95 1771 {
phungductung 0:e87aa4c49e95 1772 /* Initialize the USART ErrorCode */
phungductung 0:e87aa4c49e95 1773 husart->ErrorCode = HAL_USART_ERROR_NONE;
phungductung 0:e87aa4c49e95 1774
phungductung 0:e87aa4c49e95 1775 /* Check if the Transmitter is enabled */
phungductung 0:e87aa4c49e95 1776 if((husart->Instance->CR1 & USART_CR1_TE) == USART_CR1_TE)
phungductung 0:e87aa4c49e95 1777 {
phungductung 0:e87aa4c49e95 1778 /* Wait until TEACK flag is set */
phungductung 0:e87aa4c49e95 1779 if(USART_WaitOnFlagUntilTimeout(husart, USART_ISR_TEACK, RESET, TEACK_REACK_TIMEOUT) != HAL_OK)
phungductung 0:e87aa4c49e95 1780 {
phungductung 0:e87aa4c49e95 1781 husart->State= HAL_USART_STATE_TIMEOUT;
phungductung 0:e87aa4c49e95 1782 return HAL_TIMEOUT;
phungductung 0:e87aa4c49e95 1783 }
phungductung 0:e87aa4c49e95 1784 }
phungductung 0:e87aa4c49e95 1785 /* Check if the Receiver is enabled */
phungductung 0:e87aa4c49e95 1786 if((husart->Instance->CR1 & USART_CR1_RE) == USART_CR1_RE)
phungductung 0:e87aa4c49e95 1787 {
phungductung 0:e87aa4c49e95 1788 /* Wait until REACK flag is set */
phungductung 0:e87aa4c49e95 1789 if(USART_WaitOnFlagUntilTimeout(husart, USART_ISR_REACK, RESET, TEACK_REACK_TIMEOUT) != HAL_OK)
phungductung 0:e87aa4c49e95 1790 {
phungductung 0:e87aa4c49e95 1791 husart->State= HAL_USART_STATE_TIMEOUT;
phungductung 0:e87aa4c49e95 1792 return HAL_TIMEOUT;
phungductung 0:e87aa4c49e95 1793 }
phungductung 0:e87aa4c49e95 1794 }
phungductung 0:e87aa4c49e95 1795
phungductung 0:e87aa4c49e95 1796 /* Initialize the USART state*/
phungductung 0:e87aa4c49e95 1797 husart->State= HAL_USART_STATE_READY;
phungductung 0:e87aa4c49e95 1798
phungductung 0:e87aa4c49e95 1799 /* Process Unlocked */
phungductung 0:e87aa4c49e95 1800 __HAL_UNLOCK(husart);
phungductung 0:e87aa4c49e95 1801
phungductung 0:e87aa4c49e95 1802 return HAL_OK;
phungductung 0:e87aa4c49e95 1803 }
phungductung 0:e87aa4c49e95 1804
phungductung 0:e87aa4c49e95 1805 /**
phungductung 0:e87aa4c49e95 1806 * @}
phungductung 0:e87aa4c49e95 1807 */
phungductung 0:e87aa4c49e95 1808
phungductung 0:e87aa4c49e95 1809 #endif /* HAL_USART_MODULE_ENABLED */
phungductung 0:e87aa4c49e95 1810 /**
phungductung 0:e87aa4c49e95 1811 * @}
phungductung 0:e87aa4c49e95 1812 */
phungductung 0:e87aa4c49e95 1813
phungductung 0:e87aa4c49e95 1814 /**
phungductung 0:e87aa4c49e95 1815 * @}
phungductung 0:e87aa4c49e95 1816 */
phungductung 0:e87aa4c49e95 1817
phungductung 0:e87aa4c49e95 1818 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/