shao ziyang / mbed-src-kl05

mbed library sources

Dependents:   frdm_kl05z_gpio_test

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_NUCLEO_L053R8/stm32l0xx_hal_uart.c@323:9e901b0a5aa1, 2014-09-13 (annotated)

Committer:
shaoziyang
Date:
Sat Sep 13 14:25:46 2014 +0000
Revision:
323:9e901b0a5aa1
Parent:
181:a4cbdfbbd2f4 
test with CLOCK_SETUP = 0

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 181:a4cbdfbbd2f4 1 /**
mbed_official 181:a4cbdfbbd2f4 2 ******************************************************************************
mbed_official 181:a4cbdfbbd2f4 3 * @file stm32l0xx_hal_uart.c
mbed_official 181:a4cbdfbbd2f4 4 * @author MCD Application Team
mbed_official 181:a4cbdfbbd2f4 5 * @version V1.0.0
mbed_official 181:a4cbdfbbd2f4 6 * @date 22-April-2014
mbed_official 181:a4cbdfbbd2f4 7 * @brief UART HAL module driver.
mbed_official 181:a4cbdfbbd2f4 8 *
mbed_official 181:a4cbdfbbd2f4 9 * This file provides firmware functions to manage the following
mbed_official 181:a4cbdfbbd2f4 10 * functionalities of the Universal Asynchronous Receiver Transmitter Peripheral (UART).
mbed_official 181:a4cbdfbbd2f4 11 * + Initialization and de-initialization methods
mbed_official 181:a4cbdfbbd2f4 12 * + IO operation methods
mbed_official 181:a4cbdfbbd2f4 13 * + Peripheral Control methods
mbed_official 181:a4cbdfbbd2f4 14 *
mbed_official 181:a4cbdfbbd2f4 15 @verbatim
mbed_official 181:a4cbdfbbd2f4 16 ===============================================================================
mbed_official 181:a4cbdfbbd2f4 17 ##### How to use this driver #####
mbed_official 181:a4cbdfbbd2f4 18 ===============================================================================
mbed_official 181:a4cbdfbbd2f4 19 [..]
mbed_official 181:a4cbdfbbd2f4 20 The UART HAL driver can be used as follows:
mbed_official 181:a4cbdfbbd2f4 21
mbed_official 181:a4cbdfbbd2f4 22 (#) Declare a UART_HandleTypeDef handle structure.
mbed_official 181:a4cbdfbbd2f4 23
mbed_official 181:a4cbdfbbd2f4 24 (#) Initialize the UART low level resources by implementing the HAL_UART_MspInit() API:
mbed_official 181:a4cbdfbbd2f4 25 (##) Enable the USARTx interface clock.
mbed_official 181:a4cbdfbbd2f4 26 (##) UART pins configuration:
mbed_official 181:a4cbdfbbd2f4 27 (+++) Enable the clock for the UART GPIOs.
mbed_official 181:a4cbdfbbd2f4 28 (+++) Configure these UART pins as alternate function pull-up.
mbed_official 181:a4cbdfbbd2f4 29 (##) NVIC configuration if you need to use interrupt process (HAL_UART_Transmit_IT()
mbed_official 181:a4cbdfbbd2f4 30 and HAL_UART_Receive_IT() APIs):
mbed_official 181:a4cbdfbbd2f4 31 (+++) Configure the USARTx interrupt priority.
mbed_official 181:a4cbdfbbd2f4 32 (+++) Enable the NVIC USART IRQ handle.
mbed_official 181:a4cbdfbbd2f4 33
mbed_official 181:a4cbdfbbd2f4 34 (##) DMA Configuration if you need to use DMA process (HAL_UART_Transmit_DMA()
mbed_official 181:a4cbdfbbd2f4 35 and HAL_UART_Receive_DMA() APIs):
mbed_official 181:a4cbdfbbd2f4 36 (+++) Declare a DMA handle structure for the Tx/Rx stream.
mbed_official 181:a4cbdfbbd2f4 37 (+++) Enable the DMAx interface clock.
mbed_official 181:a4cbdfbbd2f4 38 (+++) Configure the declared DMA handle structure with the required
mbed_official 181:a4cbdfbbd2f4 39 Tx/Rx parameters.
mbed_official 181:a4cbdfbbd2f4 40 (+++) Configure the DMA Tx/Rx Stream.
mbed_official 181:a4cbdfbbd2f4 41 (+++) Associate the initialized DMA handle to the UART DMA Tx/Rx handle.
mbed_official 181:a4cbdfbbd2f4 42 (+++) Configure the priority and enable the NVIC for the transfer complete
mbed_official 181:a4cbdfbbd2f4 43 interrupt on the DMA Tx/Rx Stream.
mbed_official 181:a4cbdfbbd2f4 44
mbed_official 181:a4cbdfbbd2f4 45 (#) Program the Baud Rate, Word Length, Stop Bit, Parity, Hardware
mbed_official 181:a4cbdfbbd2f4 46 flow control and Mode(Receiver/Transmitter) in the Init structure.
mbed_official 181:a4cbdfbbd2f4 47
mbed_official 181:a4cbdfbbd2f4 48 (#) For the UART asynchronous mode, initialize the UART registers by calling
mbed_official 181:a4cbdfbbd2f4 49 the HAL_UART_Init() API.
mbed_official 181:a4cbdfbbd2f4 50
mbed_official 181:a4cbdfbbd2f4 51 (#) For the UART Half duplex mode, initialize the UART registers by calling
mbed_official 181:a4cbdfbbd2f4 52 the HAL_HalfDuplex_Init() API.
mbed_official 181:a4cbdfbbd2f4 53
mbed_official 181:a4cbdfbbd2f4 54 (#) For the LIN mode, initialize the UART registers by calling the HAL_LIN_Init() API.
mbed_official 181:a4cbdfbbd2f4 55
mbed_official 181:a4cbdfbbd2f4 56 (#) For the Multi-Processor mode, initialize the UART registers by calling
mbed_official 181:a4cbdfbbd2f4 57 the HAL_MultiProcessor_Init() API.
mbed_official 181:a4cbdfbbd2f4 58
mbed_official 181:a4cbdfbbd2f4 59 [..]
mbed_official 181:a4cbdfbbd2f4 60 (@) The specific UART interrupts (Transmission complete interrupt,
mbed_official 181:a4cbdfbbd2f4 61 RXNE interrupt and Error Interrupts) will be managed using the macros
mbed_official 181:a4cbdfbbd2f4 62 __HAL_UART_ENABLE_IT() and __HAL_UART_DISABLE_IT() inside the transmit
mbed_official 181:a4cbdfbbd2f4 63 and receive process.
mbed_official 181:a4cbdfbbd2f4 64
mbed_official 181:a4cbdfbbd2f4 65 [..]
mbed_official 181:a4cbdfbbd2f4 66 (@) These APIs (HAL_UART_Init() and HAL_HalfDuplex_Init()) configure also the
mbed_official 181:a4cbdfbbd2f4 67 low level Hardware GPIO, CLOCK, CORTEX...etc) by calling the customed
mbed_official 181:a4cbdfbbd2f4 68 HAL_UART_MspInit() API.
mbed_official 181:a4cbdfbbd2f4 69
mbed_official 181:a4cbdfbbd2f4 70 [..]
mbed_official 181:a4cbdfbbd2f4 71 Three operation modes are available within this driver :
mbed_official 181:a4cbdfbbd2f4 72
mbed_official 181:a4cbdfbbd2f4 73 *** Polling mode IO operation ***
mbed_official 181:a4cbdfbbd2f4 74 =================================
mbed_official 181:a4cbdfbbd2f4 75 [..]
mbed_official 181:a4cbdfbbd2f4 76 (+) Send an amount of data in blocking mode using HAL_UART_Transmit()
mbed_official 181:a4cbdfbbd2f4 77 (+) Receive an amount of data in blocking mode using HAL_UART_Receive()
mbed_official 181:a4cbdfbbd2f4 78
mbed_official 181:a4cbdfbbd2f4 79 *** Interrupt mode IO operation ***
mbed_official 181:a4cbdfbbd2f4 80 ===================================
mbed_official 181:a4cbdfbbd2f4 81 [..]
mbed_official 181:a4cbdfbbd2f4 82 (+) Send an amount of data in non blocking mode using HAL_UART_Transmit_IT()
mbed_official 181:a4cbdfbbd2f4 83 (+) At transmission end of half transfer HAL_UART_TxHalfCpltCallback is executed and user can
mbed_official 181:a4cbdfbbd2f4 84 add his own code by customization of function pointer HAL_UART_TxHalfCpltCallback
mbed_official 181:a4cbdfbbd2f4 85 (+) At transmission end of transfer HAL_UART_TxCpltCallback is executed and user can
mbed_official 181:a4cbdfbbd2f4 86 add his own code by customization of function pointer HAL_UART_TxCpltCallback
mbed_official 181:a4cbdfbbd2f4 87 (+) Receive an amount of data in non blocking mode using HAL_UART_Receive_IT()
mbed_official 181:a4cbdfbbd2f4 88 (+) At reception end of half transfer HAL_UART_RxHalfCpltCallback is executed and user can
mbed_official 181:a4cbdfbbd2f4 89 add his own code by customization of function pointer HAL_UART_RxHalfCpltCallback
mbed_official 181:a4cbdfbbd2f4 90 (+) At reception end of transfer HAL_UART_RxCpltCallback is executed and user can
mbed_official 181:a4cbdfbbd2f4 91 add his own code by customization of function pointer HAL_UART_RxCpltCallback
mbed_official 181:a4cbdfbbd2f4 92 (+) In case of transfer Error, HAL_UART_ErrorCallback() function is executed and user can
mbed_official 181:a4cbdfbbd2f4 93 add his own code by customization of function pointer HAL_UART_ErrorCallback
mbed_official 181:a4cbdfbbd2f4 94
mbed_official 181:a4cbdfbbd2f4 95 *** DMA mode IO operation ***
mbed_official 181:a4cbdfbbd2f4 96 ==============================
mbed_official 181:a4cbdfbbd2f4 97 [..]
mbed_official 181:a4cbdfbbd2f4 98 (+) Send an amount of data in non blocking mode (DMA) using HAL_UART_Transmit_DMA()
mbed_official 181:a4cbdfbbd2f4 99 (+) At transmission end of half transfer HAL_UART_TxHalfCpltCallback is executed and user can
mbed_official 181:a4cbdfbbd2f4 100 add his own code by customization of function pointer HAL_UART_TxHalfCpltCallback
mbed_official 181:a4cbdfbbd2f4 101 (+) At transmission end of transfer HAL_UART_TxCpltCallback is executed and user can
mbed_official 181:a4cbdfbbd2f4 102 add his own code by customization of function pointer HAL_UART_TxCpltCallback
mbed_official 181:a4cbdfbbd2f4 103 (+) Receive an amount of data in non blocking mode (DMA) using HAL_UART_Receive_DMA()
mbed_official 181:a4cbdfbbd2f4 104 (+) At reception end of half transfer HAL_UART_RxHalfCpltCallback is executed and user can
mbed_official 181:a4cbdfbbd2f4 105 add his own code by customization of function pointer HAL_UART_RxHalfCpltCallback
mbed_official 181:a4cbdfbbd2f4 106 (+) At reception end of transfer HAL_UART_RxCpltCallback is executed and user can
mbed_official 181:a4cbdfbbd2f4 107 add his own code by customization of function pointer HAL_UART_RxCpltCallback
mbed_official 181:a4cbdfbbd2f4 108 (+) In case of transfer Error, HAL_UART_ErrorCallback() function is executed and user can
mbed_official 181:a4cbdfbbd2f4 109 add his own code by customization of function pointer HAL_UART_ErrorCallback
mbed_official 181:a4cbdfbbd2f4 110 (+) Pause the DMA Transfer using HAL_UART_DMAPause()
mbed_official 181:a4cbdfbbd2f4 111 (+) Resume the DMA Transfer using HAL_UART_DMAResume()
mbed_official 181:a4cbdfbbd2f4 112 (+) Stop the DMA Transfer using HAL_UART_DMAStop()
mbed_official 181:a4cbdfbbd2f4 113
mbed_official 181:a4cbdfbbd2f4 114 *** UART HAL driver macros list ***
mbed_official 181:a4cbdfbbd2f4 115 =============================================
mbed_official 181:a4cbdfbbd2f4 116 [..]
mbed_official 181:a4cbdfbbd2f4 117 Below the list of most used macros in UART HAL driver.
mbed_official 181:a4cbdfbbd2f4 118
mbed_official 181:a4cbdfbbd2f4 119 (+) __HAL_UART_ENABLE: Enable the UART peripheral
mbed_official 181:a4cbdfbbd2f4 120 (+) __HAL_UART_DISABLE: Disable the UART peripheral
mbed_official 181:a4cbdfbbd2f4 121 (+) __HAL_UART_GET_FLAG : Check whether the specified UART flag is set or not
mbed_official 181:a4cbdfbbd2f4 122 (+) __HAL_UART_CLEAR_FLAG : Clear the specified UART pending flag
mbed_official 181:a4cbdfbbd2f4 123 (+) __HAL_UART_ENABLE_IT: Enable the specified UART interrupt
mbed_official 181:a4cbdfbbd2f4 124 (+) __HAL_UART_DISABLE_IT: Disable the specified UART interrupt
mbed_official 181:a4cbdfbbd2f4 125
mbed_official 181:a4cbdfbbd2f4 126 [..]
mbed_official 181:a4cbdfbbd2f4 127 (@) You can refer to the UART HAL driver header file for more useful macros
mbed_official 181:a4cbdfbbd2f4 128 @endverbatim
mbed_official 181:a4cbdfbbd2f4 129 ******************************************************************************
mbed_official 181:a4cbdfbbd2f4 130 * @attention
mbed_official 181:a4cbdfbbd2f4 131 *
mbed_official 181:a4cbdfbbd2f4 132 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
mbed_official 181:a4cbdfbbd2f4 133 *
mbed_official 181:a4cbdfbbd2f4 134 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 181:a4cbdfbbd2f4 135 * are permitted provided that the following conditions are met:
mbed_official 181:a4cbdfbbd2f4 136 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 181:a4cbdfbbd2f4 137 * this list of conditions and the following disclaimer.
mbed_official 181:a4cbdfbbd2f4 138 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 181:a4cbdfbbd2f4 139 * this list of conditions and the following disclaimer in the documentation
mbed_official 181:a4cbdfbbd2f4 140 * and/or other materials provided with the distribution.
mbed_official 181:a4cbdfbbd2f4 141 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 181:a4cbdfbbd2f4 142 * may be used to endorse or promote products derived from this software
mbed_official 181:a4cbdfbbd2f4 143 * without specific prior written permission.
mbed_official 181:a4cbdfbbd2f4 144 *
mbed_official 181:a4cbdfbbd2f4 145 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 181:a4cbdfbbd2f4 146 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 181:a4cbdfbbd2f4 147 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 181:a4cbdfbbd2f4 148 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 181:a4cbdfbbd2f4 149 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 181:a4cbdfbbd2f4 150 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 181:a4cbdfbbd2f4 151 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 181:a4cbdfbbd2f4 152 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 181:a4cbdfbbd2f4 153 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 181:a4cbdfbbd2f4 154 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 181:a4cbdfbbd2f4 155 *
mbed_official 181:a4cbdfbbd2f4 156 ******************************************************************************
mbed_official 181:a4cbdfbbd2f4 157 */
mbed_official 181:a4cbdfbbd2f4 158
mbed_official 181:a4cbdfbbd2f4 159 /* Includes ------------------------------------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 160 #include "stm32l0xx_hal.h"
mbed_official 181:a4cbdfbbd2f4 161
mbed_official 181:a4cbdfbbd2f4 162 /** @addtogroup STM32L0xx_HAL_Driver
mbed_official 181:a4cbdfbbd2f4 163 * @{
mbed_official 181:a4cbdfbbd2f4 164 */
mbed_official 181:a4cbdfbbd2f4 165
mbed_official 181:a4cbdfbbd2f4 166 /** @defgroup UART
mbed_official 181:a4cbdfbbd2f4 167 * @brief HAL UART module driver
mbed_official 181:a4cbdfbbd2f4 168 * @{
mbed_official 181:a4cbdfbbd2f4 169 */
mbed_official 181:a4cbdfbbd2f4 170 #ifdef HAL_UART_MODULE_ENABLED
mbed_official 181:a4cbdfbbd2f4 171
mbed_official 181:a4cbdfbbd2f4 172 /* Private typedef -----------------------------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 173 /* Private define ------------------------------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 174 #define UART_TIMEOUT_VALUE ((uint32_t) 22000)
mbed_official 181:a4cbdfbbd2f4 175 #define UART_CR1_FIELDS ((uint32_t)(USART_CR1_M | USART_CR1_PCE | USART_CR1_PS | \
mbed_official 181:a4cbdfbbd2f4 176 USART_CR1_TE | USART_CR1_RE | USART_CR1_OVER8))
mbed_official 181:a4cbdfbbd2f4 177 /* Private macro -------------------------------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 178 /* Private variables ---------------------------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 179 /* Private function prototypes -----------------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 180 static void UART_DMATransmitCplt(DMA_HandleTypeDef *hdma);
mbed_official 181:a4cbdfbbd2f4 181 static void UART_DMATxHalfCplt(DMA_HandleTypeDef *hdma);
mbed_official 181:a4cbdfbbd2f4 182 static void UART_DMAReceiveCplt(DMA_HandleTypeDef *hdma);
mbed_official 181:a4cbdfbbd2f4 183 static void UART_DMARxHalfCplt(DMA_HandleTypeDef *hdma);
mbed_official 181:a4cbdfbbd2f4 184 static void UART_DMAError(DMA_HandleTypeDef *hdma);
mbed_official 181:a4cbdfbbd2f4 185 static HAL_StatusTypeDef UART_Transmit_IT(UART_HandleTypeDef *huart);
mbed_official 181:a4cbdfbbd2f4 186 static HAL_StatusTypeDef UART_Receive_IT(UART_HandleTypeDef *huart);
mbed_official 181:a4cbdfbbd2f4 187
mbed_official 181:a4cbdfbbd2f4 188 /* Private functions ---------------------------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 189
mbed_official 181:a4cbdfbbd2f4 190 /** @defgroup UART_Private_Functions
mbed_official 181:a4cbdfbbd2f4 191 * @{
mbed_official 181:a4cbdfbbd2f4 192 */
mbed_official 181:a4cbdfbbd2f4 193
mbed_official 181:a4cbdfbbd2f4 194 /** @defgroup HAL_UART_Group1 Initialization/de-initialization methods
mbed_official 181:a4cbdfbbd2f4 195 * @brief Initialization and Configuration functions
mbed_official 181:a4cbdfbbd2f4 196 *
mbed_official 181:a4cbdfbbd2f4 197 @verbatim
mbed_official 181:a4cbdfbbd2f4 198 ===============================================================================
mbed_official 181:a4cbdfbbd2f4 199 ##### Initialization and Configuration functions #####
mbed_official 181:a4cbdfbbd2f4 200 ===============================================================================
mbed_official 181:a4cbdfbbd2f4 201 [..]
mbed_official 181:a4cbdfbbd2f4 202 This subsection provides a set of functions allowing to initialize the USARTx or the UARTy
mbed_official 181:a4cbdfbbd2f4 203 in asynchronous mode.
mbed_official 181:a4cbdfbbd2f4 204 (+) For the asynchronous mode only these parameters can be configured:
mbed_official 181:a4cbdfbbd2f4 205 (++) Baud Rate
mbed_official 181:a4cbdfbbd2f4 206 (++) Word Length
mbed_official 181:a4cbdfbbd2f4 207 (++) Stop Bit
mbed_official 181:a4cbdfbbd2f4 208 (++) Parity: If the parity is enabled, then the MSB bit of the data written
mbed_official 181:a4cbdfbbd2f4 209 in the data register is transmitted but is changed by the parity bit.
mbed_official 181:a4cbdfbbd2f4 210 Depending on the frame length defined by the M bit (8-bits or 9-bits),
mbed_official 181:a4cbdfbbd2f4 211 the possible UART frame formats are as listed in the following table:
mbed_official 181:a4cbdfbbd2f4 212 +-----------------------------------------------------------------------+
mbed_official 181:a4cbdfbbd2f4 213 | M1 bit | M0 bit | PCE bit | USART frame |
mbed_official 181:a4cbdfbbd2f4 214 |---------|---------|-----------|---------------------------------------|
mbed_official 181:a4cbdfbbd2f4 215 | 0 | 0 | 0 | | SB | 8 bit data | STB | |
mbed_official 181:a4cbdfbbd2f4 216 |---------|---------|-----------|---------------------------------------|
mbed_official 181:a4cbdfbbd2f4 217 | 0 | 0 | 1 | | SB | 7 bit data | PB | STB | |
mbed_official 181:a4cbdfbbd2f4 218 |---------|---------|-----------|---------------------------------------|
mbed_official 181:a4cbdfbbd2f4 219 | 0 | 1 | 0 | | SB | 9 bit data | STB | |
mbed_official 181:a4cbdfbbd2f4 220 |---------|---------|-----------|---------------------------------------|
mbed_official 181:a4cbdfbbd2f4 221 | 0 | 1 | 1 | | SB | 8 bit data | PB | STB | |
mbed_official 181:a4cbdfbbd2f4 222 |---------|---------|-----------|---------------------------------------|
mbed_official 181:a4cbdfbbd2f4 223 | 1 | 0 | 0 | | SB | 7 bit data | STB | |
mbed_official 181:a4cbdfbbd2f4 224 |---------|---------|-----------|---------------------------------------|
mbed_official 181:a4cbdfbbd2f4 225 | 1 | 0 | 1 | | SB | 6 bit data | PB | STB | |
mbed_official 181:a4cbdfbbd2f4 226 +-----------------------------------------------------------------------+
mbed_official 181:a4cbdfbbd2f4 227 (++) Hardware flow control
mbed_official 181:a4cbdfbbd2f4 228 (++) Receiver/transmitter modes
mbed_official 181:a4cbdfbbd2f4 229 (++) Over Sampling Method
mbed_official 181:a4cbdfbbd2f4 230 (++) One-Bit Sampling Method
mbed_official 181:a4cbdfbbd2f4 231 (+) For the asynchronous mode, the following advanced features can be configured as well:
mbed_official 181:a4cbdfbbd2f4 232 (++) TX and/or RX pin level inversion
mbed_official 181:a4cbdfbbd2f4 233 (++) data logical level inversion
mbed_official 181:a4cbdfbbd2f4 234 (++) RX and TX pins swap
mbed_official 181:a4cbdfbbd2f4 235 (++) RX overrun detection disabling
mbed_official 181:a4cbdfbbd2f4 236 (++) DMA disabling on RX error
mbed_official 181:a4cbdfbbd2f4 237 (++) MSB first on communication line
mbed_official 181:a4cbdfbbd2f4 238 (++) auto Baud rate detection
mbed_official 181:a4cbdfbbd2f4 239 [..]
mbed_official 181:a4cbdfbbd2f4 240 The HAL_UART_Init(), HAL_HalfDuplex_Init(), HAL_LIN_Init()and HAL_MultiProcessorEx_Init()API
mbed_official 181:a4cbdfbbd2f4 241 follow respectively the UART asynchronous, UART Half duplex, UART LIN mode
mbed_official 181:a4cbdfbbd2f4 242 and UART multiprocessor mode mode configuration procedures (details for the procedures
mbed_official 181:a4cbdfbbd2f4 243 are available in reference manual).
mbed_official 181:a4cbdfbbd2f4 244
mbed_official 181:a4cbdfbbd2f4 245 @endverbatim
mbed_official 181:a4cbdfbbd2f4 246 * @{
mbed_official 181:a4cbdfbbd2f4 247 */
mbed_official 181:a4cbdfbbd2f4 248
mbed_official 181:a4cbdfbbd2f4 249 /**
mbed_official 181:a4cbdfbbd2f4 250 * @brief Initializes the UART mode according to the specified
mbed_official 181:a4cbdfbbd2f4 251 * parameters in the UART_InitTypeDef and creates the associated handle .
mbed_official 181:a4cbdfbbd2f4 252 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 253 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 254 */
mbed_official 181:a4cbdfbbd2f4 255 HAL_StatusTypeDef HAL_UART_Init(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 256 {
mbed_official 181:a4cbdfbbd2f4 257 /* Check the UART handle allocation */
mbed_official 181:a4cbdfbbd2f4 258 if(huart == NULL)
mbed_official 181:a4cbdfbbd2f4 259 {
mbed_official 181:a4cbdfbbd2f4 260 return HAL_ERROR;
mbed_official 181:a4cbdfbbd2f4 261 }
mbed_official 181:a4cbdfbbd2f4 262
mbed_official 181:a4cbdfbbd2f4 263 if(huart->Init.HwFlowCtl != UART_HWCONTROL_NONE)
mbed_official 181:a4cbdfbbd2f4 264 {
mbed_official 181:a4cbdfbbd2f4 265 /* Check the parameters */
mbed_official 181:a4cbdfbbd2f4 266 assert_param(IS_UART_HWFLOW_INSTANCE(huart->Instance));
mbed_official 181:a4cbdfbbd2f4 267 }
mbed_official 181:a4cbdfbbd2f4 268 else
mbed_official 181:a4cbdfbbd2f4 269 {
mbed_official 181:a4cbdfbbd2f4 270 /* Check the parameters */
mbed_official 181:a4cbdfbbd2f4 271 assert_param(IS_UART_INSTANCE(huart->Instance));
mbed_official 181:a4cbdfbbd2f4 272 }
mbed_official 181:a4cbdfbbd2f4 273
mbed_official 181:a4cbdfbbd2f4 274 if(huart->State == HAL_UART_STATE_RESET)
mbed_official 181:a4cbdfbbd2f4 275 {
mbed_official 181:a4cbdfbbd2f4 276 /* Init the low level hardware : GPIO, CLOCK, CORTEX */
mbed_official 181:a4cbdfbbd2f4 277 HAL_UART_MspInit(huart);
mbed_official 181:a4cbdfbbd2f4 278 }
mbed_official 181:a4cbdfbbd2f4 279
mbed_official 181:a4cbdfbbd2f4 280 huart->State = HAL_UART_STATE_BUSY;
mbed_official 181:a4cbdfbbd2f4 281
mbed_official 181:a4cbdfbbd2f4 282 /* Disable the Peripheral */
mbed_official 181:a4cbdfbbd2f4 283 __HAL_UART_DISABLE(huart);
mbed_official 181:a4cbdfbbd2f4 284
mbed_official 181:a4cbdfbbd2f4 285 /* Set the UART Communication parameters */
mbed_official 181:a4cbdfbbd2f4 286 UART_SetConfig(huart);
mbed_official 181:a4cbdfbbd2f4 287
mbed_official 181:a4cbdfbbd2f4 288 if (huart->AdvancedInit.AdvFeatureInit != UART_ADVFEATURE_NO_INIT)
mbed_official 181:a4cbdfbbd2f4 289 {
mbed_official 181:a4cbdfbbd2f4 290 UART_AdvFeatureConfig(huart);
mbed_official 181:a4cbdfbbd2f4 291 }
mbed_official 181:a4cbdfbbd2f4 292
mbed_official 181:a4cbdfbbd2f4 293 /* In asynchronous mode, the following bits must be kept cleared:
mbed_official 181:a4cbdfbbd2f4 294 - LINEN and CLKEN bits in the USART_CR2 register,
mbed_official 181:a4cbdfbbd2f4 295 - SCEN, HDSEL and IREN bits in the USART_CR3 register.*/
mbed_official 181:a4cbdfbbd2f4 296 huart->Instance->CR2 &= ~(USART_CR2_LINEN | USART_CR2_CLKEN);
mbed_official 181:a4cbdfbbd2f4 297 huart->Instance->CR3 &= ~(USART_CR3_SCEN | USART_CR3_HDSEL | USART_CR3_IREN);
mbed_official 181:a4cbdfbbd2f4 298
mbed_official 181:a4cbdfbbd2f4 299 /* Enable the Peripheral */
mbed_official 181:a4cbdfbbd2f4 300 __HAL_UART_ENABLE(huart);
mbed_official 181:a4cbdfbbd2f4 301
mbed_official 181:a4cbdfbbd2f4 302 /* TEACK and/or REACK to check before moving huart->State to Ready */
mbed_official 181:a4cbdfbbd2f4 303 return (UART_CheckIdleState(huart));
mbed_official 181:a4cbdfbbd2f4 304 }
mbed_official 181:a4cbdfbbd2f4 305
mbed_official 181:a4cbdfbbd2f4 306 /**
mbed_official 181:a4cbdfbbd2f4 307 * @brief Initializes the half-duplex mode according to the specified
mbed_official 181:a4cbdfbbd2f4 308 * parameters in the UART_InitTypeDef and creates the associated handle .
mbed_official 181:a4cbdfbbd2f4 309 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 310 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 311 */
mbed_official 181:a4cbdfbbd2f4 312 HAL_StatusTypeDef HAL_HalfDuplex_Init(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 313 {
mbed_official 181:a4cbdfbbd2f4 314 /* Check the UART handle allocation */
mbed_official 181:a4cbdfbbd2f4 315 if(huart == NULL)
mbed_official 181:a4cbdfbbd2f4 316 {
mbed_official 181:a4cbdfbbd2f4 317 return HAL_ERROR;
mbed_official 181:a4cbdfbbd2f4 318 }
mbed_official 181:a4cbdfbbd2f4 319
mbed_official 181:a4cbdfbbd2f4 320 if(huart->State == HAL_UART_STATE_RESET)
mbed_official 181:a4cbdfbbd2f4 321 {
mbed_official 181:a4cbdfbbd2f4 322 /* Init the low level hardware : GPIO, CLOCK, CORTEX */
mbed_official 181:a4cbdfbbd2f4 323 HAL_UART_MspInit(huart);
mbed_official 181:a4cbdfbbd2f4 324 }
mbed_official 181:a4cbdfbbd2f4 325
mbed_official 181:a4cbdfbbd2f4 326 /* Disable the Peripheral */
mbed_official 181:a4cbdfbbd2f4 327 __HAL_UART_DISABLE(huart);
mbed_official 181:a4cbdfbbd2f4 328
mbed_official 181:a4cbdfbbd2f4 329 /* Set the UART Communication parameters */
mbed_official 181:a4cbdfbbd2f4 330 UART_SetConfig(huart);
mbed_official 181:a4cbdfbbd2f4 331
mbed_official 181:a4cbdfbbd2f4 332 if (huart->AdvancedInit.AdvFeatureInit != UART_ADVFEATURE_NO_INIT)
mbed_official 181:a4cbdfbbd2f4 333 {
mbed_official 181:a4cbdfbbd2f4 334 UART_AdvFeatureConfig(huart);
mbed_official 181:a4cbdfbbd2f4 335 }
mbed_official 181:a4cbdfbbd2f4 336
mbed_official 181:a4cbdfbbd2f4 337 /* In half-duplex mode, the following bits must be kept cleared:
mbed_official 181:a4cbdfbbd2f4 338 - LINEN and CLKEN bits in the USART_CR2 register,
mbed_official 181:a4cbdfbbd2f4 339 - SCEN and IREN bits in the USART_CR3 register.*/
mbed_official 181:a4cbdfbbd2f4 340 huart->Instance->CR2 &= ~(USART_CR2_LINEN | USART_CR2_CLKEN);
mbed_official 181:a4cbdfbbd2f4 341 huart->Instance->CR3 &= ~(USART_CR3_IREN | USART_CR3_SCEN);
mbed_official 181:a4cbdfbbd2f4 342
mbed_official 181:a4cbdfbbd2f4 343 /* Enable the Half-Duplex mode by setting the HDSEL bit in the CR3 register */
mbed_official 181:a4cbdfbbd2f4 344 huart->Instance->CR3 |= USART_CR3_HDSEL;
mbed_official 181:a4cbdfbbd2f4 345
mbed_official 181:a4cbdfbbd2f4 346 /* Enable the Peripheral */
mbed_official 181:a4cbdfbbd2f4 347 __HAL_UART_ENABLE(huart);
mbed_official 181:a4cbdfbbd2f4 348
mbed_official 181:a4cbdfbbd2f4 349 /* TEACK and/or REACK to check before moving huart->State to Ready */
mbed_official 181:a4cbdfbbd2f4 350 return (UART_CheckIdleState(huart));
mbed_official 181:a4cbdfbbd2f4 351 }
mbed_official 181:a4cbdfbbd2f4 352
mbed_official 181:a4cbdfbbd2f4 353 /**
mbed_official 181:a4cbdfbbd2f4 354 * @brief Initializes the LIN mode according to the specified
mbed_official 181:a4cbdfbbd2f4 355 * parameters in the UART_InitTypeDef and creates the associated handle .
mbed_official 181:a4cbdfbbd2f4 356 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 357 * @param BreakDetectLength: specifies the LIN break detection length.
mbed_official 181:a4cbdfbbd2f4 358 * This parameter can be one of the following values:
mbed_official 181:a4cbdfbbd2f4 359 * @arg UART_LINBREAKDETECTLENGTH_10B: 10-bit break detection
mbed_official 181:a4cbdfbbd2f4 360 * @arg UART_LINBREAKDETECTLENGTH_11B: 11-bit break detection
mbed_official 181:a4cbdfbbd2f4 361 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 362 */
mbed_official 181:a4cbdfbbd2f4 363 HAL_StatusTypeDef HAL_LIN_Init(UART_HandleTypeDef *huart, uint32_t BreakDetectLength)
mbed_official 181:a4cbdfbbd2f4 364 {
mbed_official 181:a4cbdfbbd2f4 365 /* Check the UART handle allocation */
mbed_official 181:a4cbdfbbd2f4 366 if(huart == NULL)
mbed_official 181:a4cbdfbbd2f4 367 {
mbed_official 181:a4cbdfbbd2f4 368 return HAL_ERROR;
mbed_official 181:a4cbdfbbd2f4 369 }
mbed_official 181:a4cbdfbbd2f4 370 /* Check the Break detection length parameter */
mbed_official 181:a4cbdfbbd2f4 371 assert_param(IS_UART_LIN_BREAK_DETECT_LENGTH(BreakDetectLength));
mbed_official 181:a4cbdfbbd2f4 372
mbed_official 181:a4cbdfbbd2f4 373 /* LIN mode limited to 16-bit oversampling only */
mbed_official 181:a4cbdfbbd2f4 374 if(huart->Init.OverSampling == UART_OVERSAMPLING_8)
mbed_official 181:a4cbdfbbd2f4 375 {
mbed_official 181:a4cbdfbbd2f4 376 return HAL_ERROR;
mbed_official 181:a4cbdfbbd2f4 377 }
mbed_official 181:a4cbdfbbd2f4 378
mbed_official 181:a4cbdfbbd2f4 379 if(huart->State == HAL_UART_STATE_RESET)
mbed_official 181:a4cbdfbbd2f4 380 {
mbed_official 181:a4cbdfbbd2f4 381 /* Init the low level hardware : GPIO, CLOCK, CORTEX */
mbed_official 181:a4cbdfbbd2f4 382 HAL_UART_MspInit(huart);
mbed_official 181:a4cbdfbbd2f4 383 }
mbed_official 181:a4cbdfbbd2f4 384
mbed_official 181:a4cbdfbbd2f4 385 /* Disable the Peripheral */
mbed_official 181:a4cbdfbbd2f4 386 __HAL_UART_DISABLE(huart);
mbed_official 181:a4cbdfbbd2f4 387
mbed_official 181:a4cbdfbbd2f4 388 /* Set the UART Communication parameters */
mbed_official 181:a4cbdfbbd2f4 389 UART_SetConfig(huart);
mbed_official 181:a4cbdfbbd2f4 390
mbed_official 181:a4cbdfbbd2f4 391 if (huart->AdvancedInit.AdvFeatureInit != UART_ADVFEATURE_NO_INIT)
mbed_official 181:a4cbdfbbd2f4 392 {
mbed_official 181:a4cbdfbbd2f4 393 UART_AdvFeatureConfig(huart);
mbed_official 181:a4cbdfbbd2f4 394 }
mbed_official 181:a4cbdfbbd2f4 395
mbed_official 181:a4cbdfbbd2f4 396 /* In LIN mode, the following bits must be kept cleared:
mbed_official 181:a4cbdfbbd2f4 397 - LINEN and CLKEN bits in the USART_CR2 register,
mbed_official 181:a4cbdfbbd2f4 398 - SCEN and IREN bits in the USART_CR3 register.*/
mbed_official 181:a4cbdfbbd2f4 399 huart->Instance->CR2 &= ~(USART_CR2_CLKEN);
mbed_official 181:a4cbdfbbd2f4 400 huart->Instance->CR3 &= ~(USART_CR3_HDSEL | USART_CR3_IREN | USART_CR3_SCEN);
mbed_official 181:a4cbdfbbd2f4 401
mbed_official 181:a4cbdfbbd2f4 402 /* Enable the LIN mode by setting the LINEN bit in the CR2 register */
mbed_official 181:a4cbdfbbd2f4 403 huart->Instance->CR2 |= USART_CR2_LINEN;
mbed_official 181:a4cbdfbbd2f4 404
mbed_official 181:a4cbdfbbd2f4 405 /* Set the USART LIN Break detection length. */
mbed_official 181:a4cbdfbbd2f4 406 MODIFY_REG(huart->Instance->CR2, USART_CR2_LBDL, BreakDetectLength);
mbed_official 181:a4cbdfbbd2f4 407
mbed_official 181:a4cbdfbbd2f4 408 /* Enable the Peripheral */
mbed_official 181:a4cbdfbbd2f4 409 __HAL_UART_ENABLE(huart);
mbed_official 181:a4cbdfbbd2f4 410
mbed_official 181:a4cbdfbbd2f4 411 /* TEACK and/or REACK to check before moving huart->State to Ready */
mbed_official 181:a4cbdfbbd2f4 412 return (UART_CheckIdleState(huart));
mbed_official 181:a4cbdfbbd2f4 413 }
mbed_official 181:a4cbdfbbd2f4 414
mbed_official 181:a4cbdfbbd2f4 415 /**
mbed_official 181:a4cbdfbbd2f4 416 * @brief Initializes the multiprocessor mode according to the specified
mbed_official 181:a4cbdfbbd2f4 417 * parameters in the UART_InitTypeDef and creates the associated handle.
mbed_official 181:a4cbdfbbd2f4 418 * @param huart: UART handle
mbed_official 181:a4cbdfbbd2f4 419 * @param Address: UART node address (4-, 6-, 7- or 8-bit long)
mbed_official 181:a4cbdfbbd2f4 420 * @param WakeUpMethod: specifies the UART wakeup method.
mbed_official 181:a4cbdfbbd2f4 421 * This parameter can be one of the following values:
mbed_official 181:a4cbdfbbd2f4 422 * @arg UART_WAKEUPMETHOD_IDLELINE: WakeUp by an idle line detection
mbed_official 181:a4cbdfbbd2f4 423 * @arg UART_WAKEUPMETHOD_ADDRESSMARK: WakeUp by an address mark
mbed_official 181:a4cbdfbbd2f4 424 * @note If the user resorts to idle line detection wake up, the Address parameter
mbed_official 181:a4cbdfbbd2f4 425 * is useless and ignored by the initialization function.
mbed_official 181:a4cbdfbbd2f4 426 * @note If the user resorts to address mark wake up, the address length detection
mbed_official 181:a4cbdfbbd2f4 427 * is configured by default to 4 bits only. For the UART to be able to
mbed_official 181:a4cbdfbbd2f4 428 * manage 6-, 7- or 8-bit long addresses detection, the API
mbed_official 181:a4cbdfbbd2f4 429 * HAL_MultiProcessorEx_AddressLength_Set() must be called after
mbed_official 181:a4cbdfbbd2f4 430 * HAL_MultiProcessor_Init().
mbed_official 181:a4cbdfbbd2f4 431 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 432 */
mbed_official 181:a4cbdfbbd2f4 433 HAL_StatusTypeDef HAL_MultiProcessor_Init(UART_HandleTypeDef *huart, uint8_t Address, uint32_t WakeUpMethod)
mbed_official 181:a4cbdfbbd2f4 434 {
mbed_official 181:a4cbdfbbd2f4 435 /* Check the UART handle allocation */
mbed_official 181:a4cbdfbbd2f4 436 if(huart == NULL)
mbed_official 181:a4cbdfbbd2f4 437 {
mbed_official 181:a4cbdfbbd2f4 438 return HAL_ERROR;
mbed_official 181:a4cbdfbbd2f4 439 }
mbed_official 181:a4cbdfbbd2f4 440
mbed_official 181:a4cbdfbbd2f4 441 /* Check the wake up method parameter */
mbed_official 181:a4cbdfbbd2f4 442 assert_param(IS_UART_WAKEUPMETHOD(WakeUpMethod));
mbed_official 181:a4cbdfbbd2f4 443
mbed_official 181:a4cbdfbbd2f4 444 if(huart->State == HAL_UART_STATE_RESET)
mbed_official 181:a4cbdfbbd2f4 445 {
mbed_official 181:a4cbdfbbd2f4 446 /* Init the low level hardware : GPIO, CLOCK */
mbed_official 181:a4cbdfbbd2f4 447 HAL_UART_MspInit(huart);
mbed_official 181:a4cbdfbbd2f4 448 }
mbed_official 181:a4cbdfbbd2f4 449
mbed_official 181:a4cbdfbbd2f4 450 huart->State = HAL_UART_STATE_BUSY;
mbed_official 181:a4cbdfbbd2f4 451
mbed_official 181:a4cbdfbbd2f4 452 /* Disable the Peripheral */
mbed_official 181:a4cbdfbbd2f4 453 __HAL_UART_DISABLE(huart);
mbed_official 181:a4cbdfbbd2f4 454
mbed_official 181:a4cbdfbbd2f4 455 /* Set the UART Communication parameters */
mbed_official 181:a4cbdfbbd2f4 456 UART_SetConfig(huart);
mbed_official 181:a4cbdfbbd2f4 457
mbed_official 181:a4cbdfbbd2f4 458 if (huart->AdvancedInit.AdvFeatureInit != UART_ADVFEATURE_NO_INIT)
mbed_official 181:a4cbdfbbd2f4 459 {
mbed_official 181:a4cbdfbbd2f4 460 UART_AdvFeatureConfig(huart);
mbed_official 181:a4cbdfbbd2f4 461 }
mbed_official 181:a4cbdfbbd2f4 462
mbed_official 181:a4cbdfbbd2f4 463 /* In multiprocessor mode, the following bits must be kept cleared:
mbed_official 181:a4cbdfbbd2f4 464 - LINEN and CLKEN bits in the USART_CR2 register,
mbed_official 181:a4cbdfbbd2f4 465 - SCEN, HDSEL and IREN bits in the USART_CR3 register. */
mbed_official 181:a4cbdfbbd2f4 466 huart->Instance->CR2 &= ~(USART_CR2_LINEN | USART_CR2_CLKEN);
mbed_official 181:a4cbdfbbd2f4 467 huart->Instance->CR3 &= ~(USART_CR3_SCEN | USART_CR3_HDSEL | USART_CR3_IREN);
mbed_official 181:a4cbdfbbd2f4 468
mbed_official 181:a4cbdfbbd2f4 469 if (WakeUpMethod == UART_WAKEUPMETHOD_ADDRESSMARK)
mbed_official 181:a4cbdfbbd2f4 470 {
mbed_official 181:a4cbdfbbd2f4 471 /* If address mark wake up method is chosen, set the USART address node */
mbed_official 181:a4cbdfbbd2f4 472 MODIFY_REG(huart->Instance->CR2, USART_CR2_ADD, ((uint32_t)Address << UART_CR2_ADDRESS_LSB_POS));
mbed_official 181:a4cbdfbbd2f4 473 }
mbed_official 181:a4cbdfbbd2f4 474
mbed_official 181:a4cbdfbbd2f4 475 /* Set the wake up method by setting the WAKE bit in the CR1 register */
mbed_official 181:a4cbdfbbd2f4 476 MODIFY_REG(huart->Instance->CR1, USART_CR1_WAKE, WakeUpMethod);
mbed_official 181:a4cbdfbbd2f4 477
mbed_official 181:a4cbdfbbd2f4 478 /* Enable the Peripheral */
mbed_official 181:a4cbdfbbd2f4 479 __HAL_UART_ENABLE(huart);
mbed_official 181:a4cbdfbbd2f4 480
mbed_official 181:a4cbdfbbd2f4 481 /* TEACK and/or REACK to check before moving huart->State to Ready */
mbed_official 181:a4cbdfbbd2f4 482 return (UART_CheckIdleState(huart));
mbed_official 181:a4cbdfbbd2f4 483 }
mbed_official 181:a4cbdfbbd2f4 484
mbed_official 181:a4cbdfbbd2f4 485 /**
mbed_official 181:a4cbdfbbd2f4 486 * @brief DeInitializes the UART peripheral
mbed_official 181:a4cbdfbbd2f4 487 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 488 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 489 */
mbed_official 181:a4cbdfbbd2f4 490 HAL_StatusTypeDef HAL_UART_DeInit(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 491 {
mbed_official 181:a4cbdfbbd2f4 492 /* Check the UART handle allocation */
mbed_official 181:a4cbdfbbd2f4 493 if(huart == NULL)
mbed_official 181:a4cbdfbbd2f4 494 {
mbed_official 181:a4cbdfbbd2f4 495 return HAL_ERROR;
mbed_official 181:a4cbdfbbd2f4 496 }
mbed_official 181:a4cbdfbbd2f4 497
mbed_official 181:a4cbdfbbd2f4 498 /* Check the parameters */
mbed_official 181:a4cbdfbbd2f4 499 assert_param(IS_UART_INSTANCE(huart->Instance));
mbed_official 181:a4cbdfbbd2f4 500
mbed_official 181:a4cbdfbbd2f4 501 huart->State = HAL_UART_STATE_BUSY;
mbed_official 181:a4cbdfbbd2f4 502
mbed_official 181:a4cbdfbbd2f4 503 /* Disable the Peripheral */
mbed_official 181:a4cbdfbbd2f4 504 __HAL_UART_DISABLE(huart);
mbed_official 181:a4cbdfbbd2f4 505
mbed_official 181:a4cbdfbbd2f4 506 huart->Instance->CR1 = 0x0;
mbed_official 181:a4cbdfbbd2f4 507 huart->Instance->CR2 = 0x0;
mbed_official 181:a4cbdfbbd2f4 508 huart->Instance->CR3 = 0x0;
mbed_official 181:a4cbdfbbd2f4 509
mbed_official 181:a4cbdfbbd2f4 510 /* DeInit the low level hardware */
mbed_official 181:a4cbdfbbd2f4 511 HAL_UART_MspDeInit(huart);
mbed_official 181:a4cbdfbbd2f4 512
mbed_official 181:a4cbdfbbd2f4 513 huart->ErrorCode = HAL_UART_ERROR_NONE;
mbed_official 181:a4cbdfbbd2f4 514 huart->State = HAL_UART_STATE_RESET;
mbed_official 181:a4cbdfbbd2f4 515
mbed_official 181:a4cbdfbbd2f4 516 /* Release Lock */
mbed_official 181:a4cbdfbbd2f4 517 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 518
mbed_official 181:a4cbdfbbd2f4 519 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 520 }
mbed_official 181:a4cbdfbbd2f4 521
mbed_official 181:a4cbdfbbd2f4 522 /**
mbed_official 181:a4cbdfbbd2f4 523 * @brief UART MSP Init
mbed_official 181:a4cbdfbbd2f4 524 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 525 * @retval None
mbed_official 181:a4cbdfbbd2f4 526 */
mbed_official 181:a4cbdfbbd2f4 527 __weak void HAL_UART_MspInit(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 528 {
mbed_official 181:a4cbdfbbd2f4 529 /* NOTE : This function should not be modified, when the callback is needed,
mbed_official 181:a4cbdfbbd2f4 530 the HAL_UART_MspInit can be implemented in the user file
mbed_official 181:a4cbdfbbd2f4 531 */
mbed_official 181:a4cbdfbbd2f4 532 }
mbed_official 181:a4cbdfbbd2f4 533
mbed_official 181:a4cbdfbbd2f4 534 /**
mbed_official 181:a4cbdfbbd2f4 535 * @brief UART MSP DeInit
mbed_official 181:a4cbdfbbd2f4 536 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 537 * @retval None
mbed_official 181:a4cbdfbbd2f4 538 */
mbed_official 181:a4cbdfbbd2f4 539 __weak void HAL_UART_MspDeInit(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 540 {
mbed_official 181:a4cbdfbbd2f4 541 /* NOTE : This function should not be modified, when the callback is needed,
mbed_official 181:a4cbdfbbd2f4 542 the HAL_UART_MspDeInit can be implemented in the user file
mbed_official 181:a4cbdfbbd2f4 543 */
mbed_official 181:a4cbdfbbd2f4 544 }
mbed_official 181:a4cbdfbbd2f4 545
mbed_official 181:a4cbdfbbd2f4 546 /**
mbed_official 181:a4cbdfbbd2f4 547 * @}
mbed_official 181:a4cbdfbbd2f4 548 */
mbed_official 181:a4cbdfbbd2f4 549
mbed_official 181:a4cbdfbbd2f4 550 /** @defgroup HAL_UART_Group2 IO operation methods
mbed_official 181:a4cbdfbbd2f4 551 * @brief UART Transmit/Receive functions
mbed_official 181:a4cbdfbbd2f4 552 *
mbed_official 181:a4cbdfbbd2f4 553 @verbatim
mbed_official 181:a4cbdfbbd2f4 554 ===============================================================================
mbed_official 181:a4cbdfbbd2f4 555 ##### I/O operation methods #####
mbed_official 181:a4cbdfbbd2f4 556 ===============================================================================
mbed_official 181:a4cbdfbbd2f4 557 This subsection provides a set of functions allowing to manage the UART asynchronous
mbed_official 181:a4cbdfbbd2f4 558 and Half duplex data transfers.
mbed_official 181:a4cbdfbbd2f4 559
mbed_official 181:a4cbdfbbd2f4 560 (#) There are two mode of transfer:
mbed_official 181:a4cbdfbbd2f4 561 (+) Blocking mode: The communication is performed in polling mode.
mbed_official 181:a4cbdfbbd2f4 562 The HAL status of all data processing is returned by the same function
mbed_official 181:a4cbdfbbd2f4 563 after finishing transfer.
mbed_official 181:a4cbdfbbd2f4 564 (+) No-Blocking mode: The communication is performed using Interrupts
mbed_official 181:a4cbdfbbd2f4 565 or DMA, These API's return the HAL status.
mbed_official 181:a4cbdfbbd2f4 566 The end of the data processing will be indicated through the
mbed_official 181:a4cbdfbbd2f4 567 dedicated UART IRQ when using Interrupt mode or the DMA IRQ when
mbed_official 181:a4cbdfbbd2f4 568 using DMA mode.
mbed_official 181:a4cbdfbbd2f4 569 The HAL_UART_TxCpltCallback(), HAL_UART_RxCpltCallback() user callbacks
mbed_official 181:a4cbdfbbd2f4 570 will be executed respectivelly at the end of the transmit or Receive process
mbed_official 181:a4cbdfbbd2f4 571 The HAL_UART_ErrorCallback()user callback will be executed when a communication error is detected
mbed_official 181:a4cbdfbbd2f4 572
mbed_official 181:a4cbdfbbd2f4 573 (#) Blocking mode API's are :
mbed_official 181:a4cbdfbbd2f4 574 (+) HAL_UART_Transmit()
mbed_official 181:a4cbdfbbd2f4 575 (+) HAL_UART_Receive()
mbed_official 181:a4cbdfbbd2f4 576
mbed_official 181:a4cbdfbbd2f4 577 (#) Non-Blocking mode API's with Interrupt are :
mbed_official 181:a4cbdfbbd2f4 578 (+) HAL_UART_Transmit_IT()
mbed_official 181:a4cbdfbbd2f4 579 (+) HAL_UART_Receive_IT()
mbed_official 181:a4cbdfbbd2f4 580 (+) HAL_UART_IRQHandler()
mbed_official 181:a4cbdfbbd2f4 581 (+) UART_Transmit_IT()
mbed_official 181:a4cbdfbbd2f4 582 (+) UART_Receive_IT()
mbed_official 181:a4cbdfbbd2f4 583
mbed_official 181:a4cbdfbbd2f4 584 (#) No-Blocking mode API's with DMA are :
mbed_official 181:a4cbdfbbd2f4 585 (+) HAL_UART_Transmit_DMA()
mbed_official 181:a4cbdfbbd2f4 586 (+) HAL_UART_Receive_DMA()
mbed_official 181:a4cbdfbbd2f4 587 (+) HAL_UART_DMAPause()
mbed_official 181:a4cbdfbbd2f4 588 (+) HAL_UART_DMAResume()
mbed_official 181:a4cbdfbbd2f4 589 (+) HAL_UART_DMAStop()
mbed_official 181:a4cbdfbbd2f4 590
mbed_official 181:a4cbdfbbd2f4 591 (#) A set of Transfer Complete Callbacks are provided in No_Blocking mode:
mbed_official 181:a4cbdfbbd2f4 592 (+) HAL_UART_TxHalfCpltCallback()
mbed_official 181:a4cbdfbbd2f4 593 (+) HAL_UART_TxCpltCallback()
mbed_official 181:a4cbdfbbd2f4 594 (+) HAL_UART_RxHalfCpltCallback()
mbed_official 181:a4cbdfbbd2f4 595 (+) HAL_UART_RxCpltCallback()
mbed_official 181:a4cbdfbbd2f4 596 (+) HAL_UART_ErrorCallback()
mbed_official 181:a4cbdfbbd2f4 597
mbed_official 181:a4cbdfbbd2f4 598 -@- In the Half duplex communication, it is forbidden to run the transmit
mbed_official 181:a4cbdfbbd2f4 599 and receive process in parallel, the UART state HAL_UART_STATE_BUSY_TX_RX can't be useful.
mbed_official 181:a4cbdfbbd2f4 600
mbed_official 181:a4cbdfbbd2f4 601 @endverbatim
mbed_official 181:a4cbdfbbd2f4 602 * @{
mbed_official 181:a4cbdfbbd2f4 603 */
mbed_official 181:a4cbdfbbd2f4 604
mbed_official 181:a4cbdfbbd2f4 605 /**
mbed_official 181:a4cbdfbbd2f4 606 * @brief Send an amount of data in blocking mode
mbed_official 181:a4cbdfbbd2f4 607 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 608 * @param pData: pointer to data buffer
mbed_official 181:a4cbdfbbd2f4 609 * @param Size: amount of data to be sent
mbed_official 181:a4cbdfbbd2f4 610 * @param Timeout : Timeout duration
mbed_official 181:a4cbdfbbd2f4 611 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 612 */
mbed_official 181:a4cbdfbbd2f4 613 HAL_StatusTypeDef HAL_UART_Transmit(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size, uint32_t Timeout)
mbed_official 181:a4cbdfbbd2f4 614 {
mbed_official 181:a4cbdfbbd2f4 615 uint16_t* tmp;
mbed_official 181:a4cbdfbbd2f4 616
mbed_official 181:a4cbdfbbd2f4 617 if((huart->State == HAL_UART_STATE_READY) || (huart->State == HAL_UART_STATE_BUSY_RX))
mbed_official 181:a4cbdfbbd2f4 618 {
mbed_official 181:a4cbdfbbd2f4 619 if((pData == NULL ) || (Size == 0))
mbed_official 181:a4cbdfbbd2f4 620 {
mbed_official 181:a4cbdfbbd2f4 621 return HAL_ERROR;
mbed_official 181:a4cbdfbbd2f4 622 }
mbed_official 181:a4cbdfbbd2f4 623
mbed_official 181:a4cbdfbbd2f4 624 /* Process Locked */
mbed_official 181:a4cbdfbbd2f4 625 __HAL_LOCK(huart);
mbed_official 181:a4cbdfbbd2f4 626
mbed_official 181:a4cbdfbbd2f4 627 huart->ErrorCode = HAL_UART_ERROR_NONE;
mbed_official 181:a4cbdfbbd2f4 628 /* Check if a non-blocking receive process is ongoing or not */
mbed_official 181:a4cbdfbbd2f4 629 if(huart->State == HAL_UART_STATE_BUSY_RX)
mbed_official 181:a4cbdfbbd2f4 630 {
mbed_official 181:a4cbdfbbd2f4 631 huart->State = HAL_UART_STATE_BUSY_TX_RX;
mbed_official 181:a4cbdfbbd2f4 632 }
mbed_official 181:a4cbdfbbd2f4 633 else
mbed_official 181:a4cbdfbbd2f4 634 {
mbed_official 181:a4cbdfbbd2f4 635 huart->State = HAL_UART_STATE_BUSY_TX;
mbed_official 181:a4cbdfbbd2f4 636 }
mbed_official 181:a4cbdfbbd2f4 637
mbed_official 181:a4cbdfbbd2f4 638 huart->TxXferSize = Size;
mbed_official 181:a4cbdfbbd2f4 639 huart->TxXferCount = Size;
mbed_official 181:a4cbdfbbd2f4 640 while(huart->TxXferCount > 0)
mbed_official 181:a4cbdfbbd2f4 641 {
mbed_official 181:a4cbdfbbd2f4 642 huart->TxXferCount--;
mbed_official 181:a4cbdfbbd2f4 643 if(UART_WaitOnFlagUntilTimeout(huart, UART_FLAG_TXE, RESET, Timeout) != HAL_OK)
mbed_official 181:a4cbdfbbd2f4 644 {
mbed_official 181:a4cbdfbbd2f4 645 return HAL_TIMEOUT;
mbed_official 181:a4cbdfbbd2f4 646 }
mbed_official 181:a4cbdfbbd2f4 647 if ((huart->Init.WordLength == UART_WORDLENGTH_9B) && (huart->Init.Parity == UART_PARITY_NONE))
mbed_official 181:a4cbdfbbd2f4 648 {
mbed_official 181:a4cbdfbbd2f4 649 tmp = (uint16_t*) pData;
mbed_official 181:a4cbdfbbd2f4 650 huart->Instance->TDR = (*tmp & (uint16_t)0x01FF);
mbed_official 181:a4cbdfbbd2f4 651 pData += 2;
mbed_official 181:a4cbdfbbd2f4 652 }
mbed_official 181:a4cbdfbbd2f4 653 else
mbed_official 181:a4cbdfbbd2f4 654 {
mbed_official 181:a4cbdfbbd2f4 655 huart->Instance->TDR = (*pData++ & (uint8_t)0xFF);
mbed_official 181:a4cbdfbbd2f4 656 }
mbed_official 181:a4cbdfbbd2f4 657 }
mbed_official 181:a4cbdfbbd2f4 658 if(UART_WaitOnFlagUntilTimeout(huart, UART_FLAG_TC, RESET, Timeout) != HAL_OK)
mbed_official 181:a4cbdfbbd2f4 659 {
mbed_official 181:a4cbdfbbd2f4 660 return HAL_TIMEOUT;
mbed_official 181:a4cbdfbbd2f4 661 }
mbed_official 181:a4cbdfbbd2f4 662 /* Check if a non-blocking receive Process is ongoing or not */
mbed_official 181:a4cbdfbbd2f4 663 if(huart->State == HAL_UART_STATE_BUSY_TX_RX)
mbed_official 181:a4cbdfbbd2f4 664 {
mbed_official 181:a4cbdfbbd2f4 665 huart->State = HAL_UART_STATE_BUSY_RX;
mbed_official 181:a4cbdfbbd2f4 666 }
mbed_official 181:a4cbdfbbd2f4 667 else
mbed_official 181:a4cbdfbbd2f4 668 {
mbed_official 181:a4cbdfbbd2f4 669 huart->State = HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 670 }
mbed_official 181:a4cbdfbbd2f4 671
mbed_official 181:a4cbdfbbd2f4 672 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 673 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 674
mbed_official 181:a4cbdfbbd2f4 675 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 676 }
mbed_official 181:a4cbdfbbd2f4 677 else
mbed_official 181:a4cbdfbbd2f4 678 {
mbed_official 181:a4cbdfbbd2f4 679 return HAL_BUSY;
mbed_official 181:a4cbdfbbd2f4 680 }
mbed_official 181:a4cbdfbbd2f4 681 }
mbed_official 181:a4cbdfbbd2f4 682
mbed_official 181:a4cbdfbbd2f4 683 /**
mbed_official 181:a4cbdfbbd2f4 684 * @brief Receive an amount of data in blocking mode
mbed_official 181:a4cbdfbbd2f4 685 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 686 * @param pData: pointer to data buffer
mbed_official 181:a4cbdfbbd2f4 687 * @param Size: amount of data to be received
mbed_official 181:a4cbdfbbd2f4 688 * @param Timeout : Timeout duration
mbed_official 181:a4cbdfbbd2f4 689 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 690 */
mbed_official 181:a4cbdfbbd2f4 691 HAL_StatusTypeDef HAL_UART_Receive(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size, uint32_t Timeout)
mbed_official 181:a4cbdfbbd2f4 692 {
mbed_official 181:a4cbdfbbd2f4 693 uint16_t* tmp;
mbed_official 181:a4cbdfbbd2f4 694 uint16_t uhMask;
mbed_official 181:a4cbdfbbd2f4 695
mbed_official 181:a4cbdfbbd2f4 696 if((huart->State == HAL_UART_STATE_READY) || (huart->State == HAL_UART_STATE_BUSY_TX))
mbed_official 181:a4cbdfbbd2f4 697 {
mbed_official 181:a4cbdfbbd2f4 698 if((pData == NULL ) || (Size == 0))
mbed_official 181:a4cbdfbbd2f4 699 {
mbed_official 181:a4cbdfbbd2f4 700 return HAL_ERROR;
mbed_official 181:a4cbdfbbd2f4 701 }
mbed_official 181:a4cbdfbbd2f4 702
mbed_official 181:a4cbdfbbd2f4 703 /* Process Locked */
mbed_official 181:a4cbdfbbd2f4 704 __HAL_LOCK(huart);
mbed_official 181:a4cbdfbbd2f4 705
mbed_official 181:a4cbdfbbd2f4 706 huart->ErrorCode = HAL_UART_ERROR_NONE;
mbed_official 181:a4cbdfbbd2f4 707 /* Check if a non-blocking transmit process is ongoing or not */
mbed_official 181:a4cbdfbbd2f4 708 if(huart->State == HAL_UART_STATE_BUSY_TX)
mbed_official 181:a4cbdfbbd2f4 709 {
mbed_official 181:a4cbdfbbd2f4 710 huart->State = HAL_UART_STATE_BUSY_TX_RX;
mbed_official 181:a4cbdfbbd2f4 711 }
mbed_official 181:a4cbdfbbd2f4 712 else
mbed_official 181:a4cbdfbbd2f4 713 {
mbed_official 181:a4cbdfbbd2f4 714 huart->State = HAL_UART_STATE_BUSY_RX;
mbed_official 181:a4cbdfbbd2f4 715 }
mbed_official 181:a4cbdfbbd2f4 716
mbed_official 181:a4cbdfbbd2f4 717 huart->RxXferSize = Size;
mbed_official 181:a4cbdfbbd2f4 718 huart->RxXferCount = Size;
mbed_official 181:a4cbdfbbd2f4 719
mbed_official 181:a4cbdfbbd2f4 720 /* Computation of UART mask to apply to RDR register */
mbed_official 181:a4cbdfbbd2f4 721 __HAL_UART_MASK_COMPUTATION(huart);
mbed_official 181:a4cbdfbbd2f4 722 uhMask = huart->Mask;
mbed_official 181:a4cbdfbbd2f4 723
mbed_official 181:a4cbdfbbd2f4 724 /* as long as data have to be received */
mbed_official 181:a4cbdfbbd2f4 725 while(huart->RxXferCount > 0)
mbed_official 181:a4cbdfbbd2f4 726 {
mbed_official 181:a4cbdfbbd2f4 727 huart->RxXferCount--;
mbed_official 181:a4cbdfbbd2f4 728 if(UART_WaitOnFlagUntilTimeout(huart, UART_FLAG_RXNE, RESET, Timeout) != HAL_OK)
mbed_official 181:a4cbdfbbd2f4 729 {
mbed_official 181:a4cbdfbbd2f4 730 return HAL_TIMEOUT;
mbed_official 181:a4cbdfbbd2f4 731 }
mbed_official 181:a4cbdfbbd2f4 732 if ((huart->Init.WordLength == UART_WORDLENGTH_9B) && (huart->Init.Parity == UART_PARITY_NONE))
mbed_official 181:a4cbdfbbd2f4 733 {
mbed_official 181:a4cbdfbbd2f4 734 tmp = (uint16_t*) pData ;
mbed_official 181:a4cbdfbbd2f4 735 *tmp = (uint16_t)(huart->Instance->RDR & uhMask);
mbed_official 181:a4cbdfbbd2f4 736 pData +=2;
mbed_official 181:a4cbdfbbd2f4 737 }
mbed_official 181:a4cbdfbbd2f4 738 else
mbed_official 181:a4cbdfbbd2f4 739 {
mbed_official 181:a4cbdfbbd2f4 740 *pData++ = (uint8_t)(huart->Instance->RDR & (uint8_t)uhMask);
mbed_official 181:a4cbdfbbd2f4 741 }
mbed_official 181:a4cbdfbbd2f4 742 }
mbed_official 181:a4cbdfbbd2f4 743
mbed_official 181:a4cbdfbbd2f4 744 /* Check if a non-blocking transmit Process is ongoing or not */
mbed_official 181:a4cbdfbbd2f4 745 if(huart->State == HAL_UART_STATE_BUSY_TX_RX)
mbed_official 181:a4cbdfbbd2f4 746 {
mbed_official 181:a4cbdfbbd2f4 747 huart->State = HAL_UART_STATE_BUSY_TX;
mbed_official 181:a4cbdfbbd2f4 748 }
mbed_official 181:a4cbdfbbd2f4 749 else
mbed_official 181:a4cbdfbbd2f4 750 {
mbed_official 181:a4cbdfbbd2f4 751 huart->State = HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 752 }
mbed_official 181:a4cbdfbbd2f4 753 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 754 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 755
mbed_official 181:a4cbdfbbd2f4 756 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 757 }
mbed_official 181:a4cbdfbbd2f4 758 else
mbed_official 181:a4cbdfbbd2f4 759 {
mbed_official 181:a4cbdfbbd2f4 760 return HAL_BUSY;
mbed_official 181:a4cbdfbbd2f4 761 }
mbed_official 181:a4cbdfbbd2f4 762 }
mbed_official 181:a4cbdfbbd2f4 763
mbed_official 181:a4cbdfbbd2f4 764 /**
mbed_official 181:a4cbdfbbd2f4 765 * @brief Send an amount of data in interrupt mode
mbed_official 181:a4cbdfbbd2f4 766 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 767 * @param pData: pointer to data buffer
mbed_official 181:a4cbdfbbd2f4 768 * @param Size: amount of data to be sent
mbed_official 181:a4cbdfbbd2f4 769 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 770 */
mbed_official 181:a4cbdfbbd2f4 771 HAL_StatusTypeDef HAL_UART_Transmit_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)
mbed_official 181:a4cbdfbbd2f4 772 {
mbed_official 181:a4cbdfbbd2f4 773 if((huart->State == HAL_UART_STATE_READY) || (huart->State == HAL_UART_STATE_BUSY_RX))
mbed_official 181:a4cbdfbbd2f4 774 {
mbed_official 181:a4cbdfbbd2f4 775 if((pData == NULL ) || (Size == 0))
mbed_official 181:a4cbdfbbd2f4 776 {
mbed_official 181:a4cbdfbbd2f4 777 return HAL_ERROR;
mbed_official 181:a4cbdfbbd2f4 778 }
mbed_official 181:a4cbdfbbd2f4 779
mbed_official 181:a4cbdfbbd2f4 780 /* Process Locked */
mbed_official 181:a4cbdfbbd2f4 781 __HAL_LOCK(huart);
mbed_official 181:a4cbdfbbd2f4 782
mbed_official 181:a4cbdfbbd2f4 783 huart->pTxBuffPtr = pData;
mbed_official 181:a4cbdfbbd2f4 784 huart->TxXferSize = Size;
mbed_official 181:a4cbdfbbd2f4 785 huart->TxXferCount = Size;
mbed_official 181:a4cbdfbbd2f4 786
mbed_official 181:a4cbdfbbd2f4 787 huart->ErrorCode = HAL_UART_ERROR_NONE;
mbed_official 181:a4cbdfbbd2f4 788 /* Check if a receive process is ongoing or not */
mbed_official 181:a4cbdfbbd2f4 789 if(huart->State == HAL_UART_STATE_BUSY_RX)
mbed_official 181:a4cbdfbbd2f4 790 {
mbed_official 181:a4cbdfbbd2f4 791 huart->State = HAL_UART_STATE_BUSY_TX_RX;
mbed_official 181:a4cbdfbbd2f4 792 }
mbed_official 181:a4cbdfbbd2f4 793 else
mbed_official 181:a4cbdfbbd2f4 794 {
mbed_official 181:a4cbdfbbd2f4 795 huart->State = HAL_UART_STATE_BUSY_TX;
mbed_official 181:a4cbdfbbd2f4 796 }
mbed_official 181:a4cbdfbbd2f4 797
mbed_official 181:a4cbdfbbd2f4 798 /* Enable the UART Parity Error Interrupt */
mbed_official 181:a4cbdfbbd2f4 799 __HAL_UART_ENABLE_IT(huart, UART_IT_PE);
mbed_official 181:a4cbdfbbd2f4 800
mbed_official 181:a4cbdfbbd2f4 801 /* Enable the UART Error Interrupt: (Frame error, noise error, overrun error) */
mbed_official 181:a4cbdfbbd2f4 802 __HAL_UART_ENABLE_IT(huart, UART_IT_ERR);
mbed_official 181:a4cbdfbbd2f4 803
mbed_official 181:a4cbdfbbd2f4 804 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 805 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 806
mbed_official 181:a4cbdfbbd2f4 807 /* Enable the UART Transmit Complete Interrupt */
mbed_official 181:a4cbdfbbd2f4 808 __HAL_UART_ENABLE_IT(huart, UART_IT_TC);
mbed_official 181:a4cbdfbbd2f4 809
mbed_official 181:a4cbdfbbd2f4 810 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 811 }
mbed_official 181:a4cbdfbbd2f4 812 else
mbed_official 181:a4cbdfbbd2f4 813 {
mbed_official 181:a4cbdfbbd2f4 814 return HAL_BUSY;
mbed_official 181:a4cbdfbbd2f4 815 }
mbed_official 181:a4cbdfbbd2f4 816 }
mbed_official 181:a4cbdfbbd2f4 817
mbed_official 181:a4cbdfbbd2f4 818 /**
mbed_official 181:a4cbdfbbd2f4 819 * @brief Receive an amount of data in interrupt mode
mbed_official 181:a4cbdfbbd2f4 820 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 821 * @param pData: pointer to data buffer
mbed_official 181:a4cbdfbbd2f4 822 * @param Size: amount of data to be received
mbed_official 181:a4cbdfbbd2f4 823 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 824 */
mbed_official 181:a4cbdfbbd2f4 825 HAL_StatusTypeDef HAL_UART_Receive_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)
mbed_official 181:a4cbdfbbd2f4 826 {
mbed_official 181:a4cbdfbbd2f4 827 if((huart->State == HAL_UART_STATE_READY) || (huart->State == HAL_UART_STATE_BUSY_TX))
mbed_official 181:a4cbdfbbd2f4 828 {
mbed_official 181:a4cbdfbbd2f4 829 if((pData == NULL ) || (Size == 0))
mbed_official 181:a4cbdfbbd2f4 830 {
mbed_official 181:a4cbdfbbd2f4 831 return HAL_ERROR;
mbed_official 181:a4cbdfbbd2f4 832 }
mbed_official 181:a4cbdfbbd2f4 833
mbed_official 181:a4cbdfbbd2f4 834 /* Process Locked */
mbed_official 181:a4cbdfbbd2f4 835 __HAL_LOCK(huart);
mbed_official 181:a4cbdfbbd2f4 836
mbed_official 181:a4cbdfbbd2f4 837 huart->pRxBuffPtr = pData;
mbed_official 181:a4cbdfbbd2f4 838 huart->RxXferSize = Size;
mbed_official 181:a4cbdfbbd2f4 839 huart->RxXferCount = Size;
mbed_official 181:a4cbdfbbd2f4 840
mbed_official 181:a4cbdfbbd2f4 841 /* Computation of UART mask to apply to RDR register */
mbed_official 181:a4cbdfbbd2f4 842 __HAL_UART_MASK_COMPUTATION(huart);
mbed_official 181:a4cbdfbbd2f4 843
mbed_official 181:a4cbdfbbd2f4 844 huart->ErrorCode = HAL_UART_ERROR_NONE;
mbed_official 181:a4cbdfbbd2f4 845 /* Check if a transmit process is ongoing or not */
mbed_official 181:a4cbdfbbd2f4 846 if(huart->State == HAL_UART_STATE_BUSY_TX)
mbed_official 181:a4cbdfbbd2f4 847 {
mbed_official 181:a4cbdfbbd2f4 848 huart->State = HAL_UART_STATE_BUSY_TX_RX;
mbed_official 181:a4cbdfbbd2f4 849 }
mbed_official 181:a4cbdfbbd2f4 850 else
mbed_official 181:a4cbdfbbd2f4 851 {
mbed_official 181:a4cbdfbbd2f4 852 huart->State = HAL_UART_STATE_BUSY_RX;
mbed_official 181:a4cbdfbbd2f4 853 }
mbed_official 181:a4cbdfbbd2f4 854
mbed_official 181:a4cbdfbbd2f4 855 /* Enable the UART Parity Error Interrupt */
mbed_official 181:a4cbdfbbd2f4 856 __HAL_UART_ENABLE_IT(huart, UART_IT_PE);
mbed_official 181:a4cbdfbbd2f4 857
mbed_official 181:a4cbdfbbd2f4 858 /* Enable the UART Error Interrupt: (Frame error, noise error, overrun error) */
mbed_official 181:a4cbdfbbd2f4 859 __HAL_UART_ENABLE_IT(huart, UART_IT_ERR);
mbed_official 181:a4cbdfbbd2f4 860
mbed_official 181:a4cbdfbbd2f4 861 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 862 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 863
mbed_official 181:a4cbdfbbd2f4 864 /* Enable the UART Data Register not empty Interrupt */
mbed_official 181:a4cbdfbbd2f4 865 __HAL_UART_ENABLE_IT(huart, UART_IT_RXNE);
mbed_official 181:a4cbdfbbd2f4 866
mbed_official 181:a4cbdfbbd2f4 867 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 868 }
mbed_official 181:a4cbdfbbd2f4 869 else
mbed_official 181:a4cbdfbbd2f4 870 {
mbed_official 181:a4cbdfbbd2f4 871 return HAL_BUSY;
mbed_official 181:a4cbdfbbd2f4 872 }
mbed_official 181:a4cbdfbbd2f4 873 }
mbed_official 181:a4cbdfbbd2f4 874
mbed_official 181:a4cbdfbbd2f4 875 /**
mbed_official 181:a4cbdfbbd2f4 876 * @brief Send an amount of data in DMA mode
mbed_official 181:a4cbdfbbd2f4 877 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 878 * @param pData: pointer to data buffer
mbed_official 181:a4cbdfbbd2f4 879 * @param Size: amount of data to be sent
mbed_official 181:a4cbdfbbd2f4 880 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 881 */
mbed_official 181:a4cbdfbbd2f4 882 HAL_StatusTypeDef HAL_UART_Transmit_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)
mbed_official 181:a4cbdfbbd2f4 883 {
mbed_official 181:a4cbdfbbd2f4 884 uint32_t *tmp;
mbed_official 181:a4cbdfbbd2f4 885
mbed_official 181:a4cbdfbbd2f4 886 if((huart->State == HAL_UART_STATE_READY) || (huart->State == HAL_UART_STATE_BUSY_RX))
mbed_official 181:a4cbdfbbd2f4 887 {
mbed_official 181:a4cbdfbbd2f4 888 if((pData == NULL ) || (Size == 0))
mbed_official 181:a4cbdfbbd2f4 889 {
mbed_official 181:a4cbdfbbd2f4 890 return HAL_ERROR;
mbed_official 181:a4cbdfbbd2f4 891 }
mbed_official 181:a4cbdfbbd2f4 892
mbed_official 181:a4cbdfbbd2f4 893 /* Process Locked */
mbed_official 181:a4cbdfbbd2f4 894 __HAL_LOCK(huart);
mbed_official 181:a4cbdfbbd2f4 895
mbed_official 181:a4cbdfbbd2f4 896 huart->pTxBuffPtr = pData;
mbed_official 181:a4cbdfbbd2f4 897 huart->TxXferSize = Size;
mbed_official 181:a4cbdfbbd2f4 898 huart->TxXferCount = Size;
mbed_official 181:a4cbdfbbd2f4 899
mbed_official 181:a4cbdfbbd2f4 900 huart->ErrorCode = HAL_UART_ERROR_NONE;
mbed_official 181:a4cbdfbbd2f4 901 /* Check if a receive process is ongoing or not */
mbed_official 181:a4cbdfbbd2f4 902 if(huart->State == HAL_UART_STATE_BUSY_RX)
mbed_official 181:a4cbdfbbd2f4 903 {
mbed_official 181:a4cbdfbbd2f4 904 huart->State = HAL_UART_STATE_BUSY_TX_RX;
mbed_official 181:a4cbdfbbd2f4 905 }
mbed_official 181:a4cbdfbbd2f4 906 else
mbed_official 181:a4cbdfbbd2f4 907 {
mbed_official 181:a4cbdfbbd2f4 908 huart->State = HAL_UART_STATE_BUSY_TX;
mbed_official 181:a4cbdfbbd2f4 909 }
mbed_official 181:a4cbdfbbd2f4 910
mbed_official 181:a4cbdfbbd2f4 911 /* Set the UART DMA transfert complete callback */
mbed_official 181:a4cbdfbbd2f4 912 huart->hdmatx->XferCpltCallback = UART_DMATransmitCplt;
mbed_official 181:a4cbdfbbd2f4 913
mbed_official 181:a4cbdfbbd2f4 914 /* Set the UART DMA Half transfer complete callback */
mbed_official 181:a4cbdfbbd2f4 915 huart->hdmatx->XferHalfCpltCallback = UART_DMATxHalfCplt;
mbed_official 181:a4cbdfbbd2f4 916
mbed_official 181:a4cbdfbbd2f4 917 /* Set the DMA error callback */
mbed_official 181:a4cbdfbbd2f4 918 huart->hdmatx->XferErrorCallback = UART_DMAError;
mbed_official 181:a4cbdfbbd2f4 919
mbed_official 181:a4cbdfbbd2f4 920 /* Enable the UART transmit DMA Stream */
mbed_official 181:a4cbdfbbd2f4 921 tmp = (uint32_t*)&pData;
mbed_official 181:a4cbdfbbd2f4 922 HAL_DMA_Start_IT(huart->hdmatx, *(uint32_t*)tmp, (uint32_t)&huart->Instance->TDR, Size);
mbed_official 181:a4cbdfbbd2f4 923
mbed_official 181:a4cbdfbbd2f4 924 /* Enable the DMA transfer for transmit request by setting the DMAT bit
mbed_official 181:a4cbdfbbd2f4 925 in the UART CR3 register */
mbed_official 181:a4cbdfbbd2f4 926 huart->Instance->CR3 |= USART_CR3_DMAT;
mbed_official 181:a4cbdfbbd2f4 927
mbed_official 181:a4cbdfbbd2f4 928 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 929 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 930
mbed_official 181:a4cbdfbbd2f4 931 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 932 }
mbed_official 181:a4cbdfbbd2f4 933 else
mbed_official 181:a4cbdfbbd2f4 934 {
mbed_official 181:a4cbdfbbd2f4 935 return HAL_BUSY;
mbed_official 181:a4cbdfbbd2f4 936 }
mbed_official 181:a4cbdfbbd2f4 937 }
mbed_official 181:a4cbdfbbd2f4 938
mbed_official 181:a4cbdfbbd2f4 939 /**
mbed_official 181:a4cbdfbbd2f4 940 * @brief Receive an amount of data in DMA mode
mbed_official 181:a4cbdfbbd2f4 941 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 942 * @param pData: pointer to data buffer
mbed_official 181:a4cbdfbbd2f4 943 * @param Size: amount of data to be received
mbed_official 181:a4cbdfbbd2f4 944 * @note When the UART parity is enabled (PCE = 1) the data received contain the parity bit.
mbed_official 181:a4cbdfbbd2f4 945 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 946 */
mbed_official 181:a4cbdfbbd2f4 947 HAL_StatusTypeDef HAL_UART_Receive_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)
mbed_official 181:a4cbdfbbd2f4 948 {
mbed_official 181:a4cbdfbbd2f4 949 uint32_t *tmp;
mbed_official 181:a4cbdfbbd2f4 950
mbed_official 181:a4cbdfbbd2f4 951 if((huart->State == HAL_UART_STATE_READY) || (huart->State == HAL_UART_STATE_BUSY_TX))
mbed_official 181:a4cbdfbbd2f4 952 {
mbed_official 181:a4cbdfbbd2f4 953 if((pData == NULL ) || (Size == 0))
mbed_official 181:a4cbdfbbd2f4 954 {
mbed_official 181:a4cbdfbbd2f4 955 return HAL_ERROR;
mbed_official 181:a4cbdfbbd2f4 956 }
mbed_official 181:a4cbdfbbd2f4 957
mbed_official 181:a4cbdfbbd2f4 958 /* Process Locked */
mbed_official 181:a4cbdfbbd2f4 959 __HAL_LOCK(huart);
mbed_official 181:a4cbdfbbd2f4 960
mbed_official 181:a4cbdfbbd2f4 961 huart->pRxBuffPtr = pData;
mbed_official 181:a4cbdfbbd2f4 962 huart->RxXferSize = Size;
mbed_official 181:a4cbdfbbd2f4 963
mbed_official 181:a4cbdfbbd2f4 964 huart->ErrorCode = HAL_UART_ERROR_NONE;
mbed_official 181:a4cbdfbbd2f4 965 /* Check if a transmit process is ongoing or not */
mbed_official 181:a4cbdfbbd2f4 966 if(huart->State == HAL_UART_STATE_BUSY_TX)
mbed_official 181:a4cbdfbbd2f4 967 {
mbed_official 181:a4cbdfbbd2f4 968 huart->State = HAL_UART_STATE_BUSY_TX_RX;
mbed_official 181:a4cbdfbbd2f4 969 }
mbed_official 181:a4cbdfbbd2f4 970 else
mbed_official 181:a4cbdfbbd2f4 971 {
mbed_official 181:a4cbdfbbd2f4 972 huart->State = HAL_UART_STATE_BUSY_RX;
mbed_official 181:a4cbdfbbd2f4 973 }
mbed_official 181:a4cbdfbbd2f4 974
mbed_official 181:a4cbdfbbd2f4 975 /* Set the UART DMA transfert complete callback */
mbed_official 181:a4cbdfbbd2f4 976 huart->hdmarx->XferCpltCallback = UART_DMAReceiveCplt;
mbed_official 181:a4cbdfbbd2f4 977
mbed_official 181:a4cbdfbbd2f4 978 /* Set the UART DMA Half transfer complete callback */
mbed_official 181:a4cbdfbbd2f4 979 huart->hdmarx->XferHalfCpltCallback = UART_DMARxHalfCplt;
mbed_official 181:a4cbdfbbd2f4 980
mbed_official 181:a4cbdfbbd2f4 981 /* Set the DMA error callback */
mbed_official 181:a4cbdfbbd2f4 982 huart->hdmarx->XferErrorCallback = UART_DMAError;
mbed_official 181:a4cbdfbbd2f4 983
mbed_official 181:a4cbdfbbd2f4 984 /* Enable the DMA Stream */
mbed_official 181:a4cbdfbbd2f4 985 tmp = (uint32_t*)&pData;
mbed_official 181:a4cbdfbbd2f4 986 HAL_DMA_Start_IT(huart->hdmarx, (uint32_t)&huart->Instance->RDR, *(uint32_t*)tmp, Size);
mbed_official 181:a4cbdfbbd2f4 987
mbed_official 181:a4cbdfbbd2f4 988 /* Enable the DMA transfer for the receiver request by setting the DMAR bit
mbed_official 181:a4cbdfbbd2f4 989 in the UART CR3 register */
mbed_official 181:a4cbdfbbd2f4 990 huart->Instance->CR3 |= USART_CR3_DMAR;
mbed_official 181:a4cbdfbbd2f4 991
mbed_official 181:a4cbdfbbd2f4 992 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 993 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 994
mbed_official 181:a4cbdfbbd2f4 995 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 996 }
mbed_official 181:a4cbdfbbd2f4 997 else
mbed_official 181:a4cbdfbbd2f4 998 {
mbed_official 181:a4cbdfbbd2f4 999 return HAL_BUSY;
mbed_official 181:a4cbdfbbd2f4 1000 }
mbed_official 181:a4cbdfbbd2f4 1001 }
mbed_official 181:a4cbdfbbd2f4 1002
mbed_official 181:a4cbdfbbd2f4 1003 /**
mbed_official 181:a4cbdfbbd2f4 1004 * @brief Pauses the DMA Transfer.
mbed_official 181:a4cbdfbbd2f4 1005 * @param huart: UART handle
mbed_official 181:a4cbdfbbd2f4 1006 * @retval None
mbed_official 181:a4cbdfbbd2f4 1007 */
mbed_official 181:a4cbdfbbd2f4 1008 HAL_StatusTypeDef HAL_UART_DMAPause(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1009 {
mbed_official 181:a4cbdfbbd2f4 1010 /* Process Locked */
mbed_official 181:a4cbdfbbd2f4 1011 __HAL_LOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1012
mbed_official 181:a4cbdfbbd2f4 1013 if(huart->State == HAL_UART_STATE_BUSY_TX)
mbed_official 181:a4cbdfbbd2f4 1014 {
mbed_official 181:a4cbdfbbd2f4 1015 /* Disable the UART DMA Tx request */
mbed_official 181:a4cbdfbbd2f4 1016 huart->Instance->CR3 &= (uint32_t)(~USART_CR3_DMAT);
mbed_official 181:a4cbdfbbd2f4 1017 }
mbed_official 181:a4cbdfbbd2f4 1018 else if(huart->State == HAL_UART_STATE_BUSY_RX)
mbed_official 181:a4cbdfbbd2f4 1019 {
mbed_official 181:a4cbdfbbd2f4 1020 /* Disable the UART DMA Rx request */
mbed_official 181:a4cbdfbbd2f4 1021 huart->Instance->CR3 &= (uint32_t)(~USART_CR3_DMAR);
mbed_official 181:a4cbdfbbd2f4 1022 }
mbed_official 181:a4cbdfbbd2f4 1023 else if(huart->State == HAL_UART_STATE_BUSY_TX_RX)
mbed_official 181:a4cbdfbbd2f4 1024 {
mbed_official 181:a4cbdfbbd2f4 1025 /* Disable the UART DMA Tx request */
mbed_official 181:a4cbdfbbd2f4 1026 huart->Instance->CR3 &= (uint32_t)(~USART_CR3_DMAT);
mbed_official 181:a4cbdfbbd2f4 1027 /* Disable the UART DMA Rx request */
mbed_official 181:a4cbdfbbd2f4 1028 huart->Instance->CR3 &= (uint32_t)(~USART_CR3_DMAR);
mbed_official 181:a4cbdfbbd2f4 1029 }
mbed_official 181:a4cbdfbbd2f4 1030 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 1031 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1032
mbed_official 181:a4cbdfbbd2f4 1033 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 1034 }
mbed_official 181:a4cbdfbbd2f4 1035
mbed_official 181:a4cbdfbbd2f4 1036 /**
mbed_official 181:a4cbdfbbd2f4 1037 * @brief Resumes the DMA Transfer.
mbed_official 181:a4cbdfbbd2f4 1038 * @param huart: UART handle
mbed_official 181:a4cbdfbbd2f4 1039 * @retval None
mbed_official 181:a4cbdfbbd2f4 1040 */
mbed_official 181:a4cbdfbbd2f4 1041 HAL_StatusTypeDef HAL_UART_DMAResume(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1042 {
mbed_official 181:a4cbdfbbd2f4 1043 /* Process Locked */
mbed_official 181:a4cbdfbbd2f4 1044 __HAL_LOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1045
mbed_official 181:a4cbdfbbd2f4 1046 if(huart->State == HAL_UART_STATE_BUSY_TX)
mbed_official 181:a4cbdfbbd2f4 1047 {
mbed_official 181:a4cbdfbbd2f4 1048 /* Enable the UART DMA Tx request */
mbed_official 181:a4cbdfbbd2f4 1049 huart->Instance->CR3 |= USART_CR3_DMAT;
mbed_official 181:a4cbdfbbd2f4 1050 }
mbed_official 181:a4cbdfbbd2f4 1051 else if(huart->State == HAL_UART_STATE_BUSY_RX)
mbed_official 181:a4cbdfbbd2f4 1052 {
mbed_official 181:a4cbdfbbd2f4 1053 /* Enable the UART DMA Rx request */
mbed_official 181:a4cbdfbbd2f4 1054 huart->Instance->CR3 |= USART_CR3_DMAR;
mbed_official 181:a4cbdfbbd2f4 1055 }
mbed_official 181:a4cbdfbbd2f4 1056 else if(huart->State == HAL_UART_STATE_BUSY_TX_RX)
mbed_official 181:a4cbdfbbd2f4 1057 {
mbed_official 181:a4cbdfbbd2f4 1058 /* Enable the UART DMA Rx request before the DMA Tx request */
mbed_official 181:a4cbdfbbd2f4 1059 huart->Instance->CR3 |= USART_CR3_DMAR;
mbed_official 181:a4cbdfbbd2f4 1060 /* Enable the UART DMA Tx request */
mbed_official 181:a4cbdfbbd2f4 1061 huart->Instance->CR3 |= USART_CR3_DMAT;
mbed_official 181:a4cbdfbbd2f4 1062 }
mbed_official 181:a4cbdfbbd2f4 1063
mbed_official 181:a4cbdfbbd2f4 1064 /* If the UART peripheral is still not enabled, enable it */
mbed_official 181:a4cbdfbbd2f4 1065 if ((huart->Instance->CR1 & USART_CR1_UE) == 0)
mbed_official 181:a4cbdfbbd2f4 1066 {
mbed_official 181:a4cbdfbbd2f4 1067 /* Enable UART peripheral */
mbed_official 181:a4cbdfbbd2f4 1068 __HAL_UART_ENABLE(huart);
mbed_official 181:a4cbdfbbd2f4 1069 }
mbed_official 181:a4cbdfbbd2f4 1070
mbed_official 181:a4cbdfbbd2f4 1071 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 1072 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1073
mbed_official 181:a4cbdfbbd2f4 1074 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 1075 }
mbed_official 181:a4cbdfbbd2f4 1076
mbed_official 181:a4cbdfbbd2f4 1077 /**
mbed_official 181:a4cbdfbbd2f4 1078 * @brief Stops the DMA Transfer.
mbed_official 181:a4cbdfbbd2f4 1079 * @param huart: UART handle
mbed_official 181:a4cbdfbbd2f4 1080 * @retval None
mbed_official 181:a4cbdfbbd2f4 1081 */
mbed_official 181:a4cbdfbbd2f4 1082 HAL_StatusTypeDef HAL_UART_DMAStop(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1083 {
mbed_official 181:a4cbdfbbd2f4 1084 /* Process Locked */
mbed_official 181:a4cbdfbbd2f4 1085 __HAL_LOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1086
mbed_official 181:a4cbdfbbd2f4 1087 /* Disable the UART Tx/Rx DMA requests */
mbed_official 181:a4cbdfbbd2f4 1088 huart->Instance->CR3 &= ~USART_CR3_DMAT;
mbed_official 181:a4cbdfbbd2f4 1089 huart->Instance->CR3 &= ~USART_CR3_DMAR;
mbed_official 181:a4cbdfbbd2f4 1090
mbed_official 181:a4cbdfbbd2f4 1091 /* Abort the UART DMA tx channel */
mbed_official 181:a4cbdfbbd2f4 1092 if(huart->hdmatx != NULL)
mbed_official 181:a4cbdfbbd2f4 1093 {
mbed_official 181:a4cbdfbbd2f4 1094 HAL_DMA_Abort(huart->hdmatx);
mbed_official 181:a4cbdfbbd2f4 1095 }
mbed_official 181:a4cbdfbbd2f4 1096 /* Abort the UART DMA rx channel */
mbed_official 181:a4cbdfbbd2f4 1097 if(huart->hdmarx != NULL)
mbed_official 181:a4cbdfbbd2f4 1098 {
mbed_official 181:a4cbdfbbd2f4 1099 HAL_DMA_Abort(huart->hdmarx);
mbed_official 181:a4cbdfbbd2f4 1100 }
mbed_official 181:a4cbdfbbd2f4 1101
mbed_official 181:a4cbdfbbd2f4 1102 /* Disable UART peripheral */
mbed_official 181:a4cbdfbbd2f4 1103 __HAL_UART_DISABLE(huart);
mbed_official 181:a4cbdfbbd2f4 1104
mbed_official 181:a4cbdfbbd2f4 1105 huart->State = HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 1106
mbed_official 181:a4cbdfbbd2f4 1107 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 1108 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1109
mbed_official 181:a4cbdfbbd2f4 1110 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 1111 }
mbed_official 181:a4cbdfbbd2f4 1112
mbed_official 181:a4cbdfbbd2f4 1113 /**
mbed_official 181:a4cbdfbbd2f4 1114 * @brief This function handles UART interrupt request.
mbed_official 181:a4cbdfbbd2f4 1115 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 1116 * @retval None
mbed_official 181:a4cbdfbbd2f4 1117 */
mbed_official 181:a4cbdfbbd2f4 1118 void HAL_UART_IRQHandler(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1119 {
mbed_official 181:a4cbdfbbd2f4 1120 /* UART parity error interrupt occurred ------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 1121 if((__HAL_UART_GET_IT(huart, UART_IT_PE) != RESET) && (__HAL_UART_GET_IT_SOURCE(huart, UART_IT_PE) != RESET))
mbed_official 181:a4cbdfbbd2f4 1122 {
mbed_official 181:a4cbdfbbd2f4 1123 __HAL_UART_CLEAR_IT(huart, UART_CLEAR_PEF);
mbed_official 181:a4cbdfbbd2f4 1124
mbed_official 181:a4cbdfbbd2f4 1125 huart->ErrorCode |= HAL_UART_ERROR_PE;
mbed_official 181:a4cbdfbbd2f4 1126 /* Set the UART state ready to be able to start again the process */
mbed_official 181:a4cbdfbbd2f4 1127 huart->State = HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 1128 }
mbed_official 181:a4cbdfbbd2f4 1129
mbed_official 181:a4cbdfbbd2f4 1130 /* UART frame error interrupt occured --------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 1131 if((__HAL_UART_GET_IT(huart, UART_IT_FE) != RESET) && (__HAL_UART_GET_IT_SOURCE(huart, UART_IT_ERR) != RESET))
mbed_official 181:a4cbdfbbd2f4 1132 {
mbed_official 181:a4cbdfbbd2f4 1133 __HAL_UART_CLEAR_IT(huart, UART_CLEAR_FEF);
mbed_official 181:a4cbdfbbd2f4 1134
mbed_official 181:a4cbdfbbd2f4 1135 huart->ErrorCode |= HAL_UART_ERROR_FE;
mbed_official 181:a4cbdfbbd2f4 1136 /* Set the UART state ready to be able to start again the process */
mbed_official 181:a4cbdfbbd2f4 1137 huart->State = HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 1138 }
mbed_official 181:a4cbdfbbd2f4 1139
mbed_official 181:a4cbdfbbd2f4 1140 /* UART noise error interrupt occured --------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 1141 if((__HAL_UART_GET_IT(huart, UART_IT_NE) != RESET) && (__HAL_UART_GET_IT_SOURCE(huart, UART_IT_ERR) != RESET))
mbed_official 181:a4cbdfbbd2f4 1142 {
mbed_official 181:a4cbdfbbd2f4 1143 __HAL_UART_CLEAR_IT(huart, UART_CLEAR_NEF);
mbed_official 181:a4cbdfbbd2f4 1144
mbed_official 181:a4cbdfbbd2f4 1145 huart->ErrorCode |= HAL_UART_ERROR_NE;
mbed_official 181:a4cbdfbbd2f4 1146 /* Set the UART state ready to be able to start again the process */
mbed_official 181:a4cbdfbbd2f4 1147 huart->State = HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 1148 }
mbed_official 181:a4cbdfbbd2f4 1149
mbed_official 181:a4cbdfbbd2f4 1150 /* UART Over-Run interrupt occured -----------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 1151 if((__HAL_UART_GET_IT(huart, UART_IT_ORE) != RESET) && (__HAL_UART_GET_IT_SOURCE(huart, UART_IT_ERR) != RESET))
mbed_official 181:a4cbdfbbd2f4 1152 {
mbed_official 181:a4cbdfbbd2f4 1153 __HAL_UART_CLEAR_IT(huart, UART_CLEAR_OREF);
mbed_official 181:a4cbdfbbd2f4 1154
mbed_official 181:a4cbdfbbd2f4 1155 huart->ErrorCode |= HAL_UART_ERROR_ORE;
mbed_official 181:a4cbdfbbd2f4 1156 /* Set the UART state ready to be able to start again the process */
mbed_official 181:a4cbdfbbd2f4 1157 huart->State = HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 1158 }
mbed_official 181:a4cbdfbbd2f4 1159
mbed_official 181:a4cbdfbbd2f4 1160 /* Call UART Error Call back function if need be --------------------------*/
mbed_official 181:a4cbdfbbd2f4 1161 if(huart->ErrorCode != HAL_UART_ERROR_NONE)
mbed_official 181:a4cbdfbbd2f4 1162 {
mbed_official 181:a4cbdfbbd2f4 1163 HAL_UART_ErrorCallback(huart);
mbed_official 181:a4cbdfbbd2f4 1164 }
mbed_official 181:a4cbdfbbd2f4 1165
mbed_official 181:a4cbdfbbd2f4 1166 /* UART Wake Up interrupt occured ------------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 1167 if((__HAL_UART_GET_IT(huart, UART_IT_WUF) != RESET) && (__HAL_UART_GET_IT_SOURCE(huart, UART_IT_WUF) != RESET))
mbed_official 181:a4cbdfbbd2f4 1168 {
mbed_official 181:a4cbdfbbd2f4 1169 __HAL_UART_CLEAR_IT(huart, UART_CLEAR_WUF);
mbed_official 181:a4cbdfbbd2f4 1170 /* Set the UART state ready to be able to start again the process */
mbed_official 181:a4cbdfbbd2f4 1171 huart->State = HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 1172 HAL_UART_WakeupCallback(huart);
mbed_official 181:a4cbdfbbd2f4 1173 }
mbed_official 181:a4cbdfbbd2f4 1174
mbed_official 181:a4cbdfbbd2f4 1175 /* UART in mode Receiver ---------------------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 1176 if((__HAL_UART_GET_IT(huart, UART_IT_RXNE) != RESET) && (__HAL_UART_GET_IT_SOURCE(huart, UART_IT_RXNE) != RESET))
mbed_official 181:a4cbdfbbd2f4 1177 {
mbed_official 181:a4cbdfbbd2f4 1178 UART_Receive_IT(huart);
mbed_official 181:a4cbdfbbd2f4 1179 /* Clear RXNE interrupt flag */
mbed_official 181:a4cbdfbbd2f4 1180 __HAL_UART_SEND_REQ(huart, UART_RXDATA_FLUSH_REQUEST);
mbed_official 181:a4cbdfbbd2f4 1181 }
mbed_official 181:a4cbdfbbd2f4 1182
mbed_official 181:a4cbdfbbd2f4 1183 /* UART in mode Transmitter ------------------------------------------------*/
mbed_official 181:a4cbdfbbd2f4 1184 if((__HAL_UART_GET_IT(huart, UART_IT_TC) != RESET) &&(__HAL_UART_GET_IT_SOURCE(huart, UART_IT_TC) != RESET))
mbed_official 181:a4cbdfbbd2f4 1185 {
mbed_official 181:a4cbdfbbd2f4 1186 UART_Transmit_IT(huart);
mbed_official 181:a4cbdfbbd2f4 1187 }
mbed_official 181:a4cbdfbbd2f4 1188
mbed_official 181:a4cbdfbbd2f4 1189 if(huart->ErrorCode != HAL_UART_ERROR_NONE)
mbed_official 181:a4cbdfbbd2f4 1190 {
mbed_official 181:a4cbdfbbd2f4 1191 HAL_UART_ErrorCallback(huart);
mbed_official 181:a4cbdfbbd2f4 1192 }
mbed_official 181:a4cbdfbbd2f4 1193 }
mbed_official 181:a4cbdfbbd2f4 1194
mbed_official 181:a4cbdfbbd2f4 1195 /**
mbed_official 181:a4cbdfbbd2f4 1196 * @brief DMA UART transmit process complete callback
mbed_official 181:a4cbdfbbd2f4 1197 * @param hdma: DMA handle
mbed_official 181:a4cbdfbbd2f4 1198 * @retval None
mbed_official 181:a4cbdfbbd2f4 1199 */
mbed_official 181:a4cbdfbbd2f4 1200 static void UART_DMATransmitCplt(DMA_HandleTypeDef *hdma)
mbed_official 181:a4cbdfbbd2f4 1201 {
mbed_official 181:a4cbdfbbd2f4 1202 UART_HandleTypeDef* huart = ( UART_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 181:a4cbdfbbd2f4 1203 huart->TxXferCount = 0;
mbed_official 181:a4cbdfbbd2f4 1204
mbed_official 181:a4cbdfbbd2f4 1205 /* Disable the DMA transfer for transmit request by setting the DMAT bit
mbed_official 181:a4cbdfbbd2f4 1206 in the UART CR3 register */
mbed_official 181:a4cbdfbbd2f4 1207 huart->Instance->CR3 &= (uint32_t)~((uint32_t)USART_CR3_DMAT);
mbed_official 181:a4cbdfbbd2f4 1208
mbed_official 181:a4cbdfbbd2f4 1209 /* Wait for UART TC Flag */
mbed_official 181:a4cbdfbbd2f4 1210 if(UART_WaitOnFlagUntilTimeout(huart, UART_FLAG_TC, RESET, UART_TIMEOUT_VALUE) != HAL_OK)
mbed_official 181:a4cbdfbbd2f4 1211 {
mbed_official 181:a4cbdfbbd2f4 1212 /* Timeout Occured */
mbed_official 181:a4cbdfbbd2f4 1213 huart->State = HAL_UART_STATE_TIMEOUT;
mbed_official 181:a4cbdfbbd2f4 1214 HAL_UART_ErrorCallback(huart);
mbed_official 181:a4cbdfbbd2f4 1215 }
mbed_official 181:a4cbdfbbd2f4 1216 else
mbed_official 181:a4cbdfbbd2f4 1217 {
mbed_official 181:a4cbdfbbd2f4 1218 /* No Timeout */
mbed_official 181:a4cbdfbbd2f4 1219 /* Check if a receive process is ongoing or not */
mbed_official 181:a4cbdfbbd2f4 1220 if(huart->State == HAL_UART_STATE_BUSY_TX_RX)
mbed_official 181:a4cbdfbbd2f4 1221 {
mbed_official 181:a4cbdfbbd2f4 1222 huart->State = HAL_UART_STATE_BUSY_RX;
mbed_official 181:a4cbdfbbd2f4 1223 }
mbed_official 181:a4cbdfbbd2f4 1224 else
mbed_official 181:a4cbdfbbd2f4 1225 {
mbed_official 181:a4cbdfbbd2f4 1226 huart->State = HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 1227 }
mbed_official 181:a4cbdfbbd2f4 1228 HAL_UART_TxCpltCallback(huart);
mbed_official 181:a4cbdfbbd2f4 1229 }
mbed_official 181:a4cbdfbbd2f4 1230 }
mbed_official 181:a4cbdfbbd2f4 1231
mbed_official 181:a4cbdfbbd2f4 1232 /**
mbed_official 181:a4cbdfbbd2f4 1233 * @brief DMA UART transmit process half complete callback
mbed_official 181:a4cbdfbbd2f4 1234 * @param hdma : DMA handle
mbed_official 181:a4cbdfbbd2f4 1235 * @retval None
mbed_official 181:a4cbdfbbd2f4 1236 */
mbed_official 181:a4cbdfbbd2f4 1237 static void UART_DMATxHalfCplt(DMA_HandleTypeDef *hdma)
mbed_official 181:a4cbdfbbd2f4 1238 {
mbed_official 181:a4cbdfbbd2f4 1239 UART_HandleTypeDef* huart = (UART_HandleTypeDef*)((DMA_HandleTypeDef*)hdma)->Parent;
mbed_official 181:a4cbdfbbd2f4 1240
mbed_official 181:a4cbdfbbd2f4 1241 HAL_UART_TxHalfCpltCallback(huart);
mbed_official 181:a4cbdfbbd2f4 1242 }
mbed_official 181:a4cbdfbbd2f4 1243
mbed_official 181:a4cbdfbbd2f4 1244 /**
mbed_official 181:a4cbdfbbd2f4 1245 * @brief DMA UART receive process complete callback
mbed_official 181:a4cbdfbbd2f4 1246 * @param hdma: DMA handle
mbed_official 181:a4cbdfbbd2f4 1247 * @retval None
mbed_official 181:a4cbdfbbd2f4 1248 */
mbed_official 181:a4cbdfbbd2f4 1249 static void UART_DMAReceiveCplt(DMA_HandleTypeDef *hdma)
mbed_official 181:a4cbdfbbd2f4 1250 {
mbed_official 181:a4cbdfbbd2f4 1251 UART_HandleTypeDef* huart = ( UART_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 181:a4cbdfbbd2f4 1252 huart->RxXferCount = 0;
mbed_official 181:a4cbdfbbd2f4 1253
mbed_official 181:a4cbdfbbd2f4 1254 /* Disable the DMA transfer for the receiver request by setting the DMAR bit
mbed_official 181:a4cbdfbbd2f4 1255 in the UART CR3 register */
mbed_official 181:a4cbdfbbd2f4 1256 huart->Instance->CR3 &= (uint32_t)~((uint32_t)USART_CR3_DMAR);
mbed_official 181:a4cbdfbbd2f4 1257
mbed_official 181:a4cbdfbbd2f4 1258 /* Check if a transmit Process is ongoing or not */
mbed_official 181:a4cbdfbbd2f4 1259 if(huart->State == HAL_UART_STATE_BUSY_TX_RX)
mbed_official 181:a4cbdfbbd2f4 1260 {
mbed_official 181:a4cbdfbbd2f4 1261 huart->State = HAL_UART_STATE_BUSY_TX;
mbed_official 181:a4cbdfbbd2f4 1262 }
mbed_official 181:a4cbdfbbd2f4 1263 else
mbed_official 181:a4cbdfbbd2f4 1264 {
mbed_official 181:a4cbdfbbd2f4 1265 huart->State = HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 1266 }
mbed_official 181:a4cbdfbbd2f4 1267 HAL_UART_RxCpltCallback(huart);
mbed_official 181:a4cbdfbbd2f4 1268 }
mbed_official 181:a4cbdfbbd2f4 1269
mbed_official 181:a4cbdfbbd2f4 1270 /**
mbed_official 181:a4cbdfbbd2f4 1271 * @brief DMA UART receive process half complete callback
mbed_official 181:a4cbdfbbd2f4 1272 * @param hdma : DMA handle
mbed_official 181:a4cbdfbbd2f4 1273 * @retval None
mbed_official 181:a4cbdfbbd2f4 1274 */
mbed_official 181:a4cbdfbbd2f4 1275 static void UART_DMARxHalfCplt(DMA_HandleTypeDef *hdma)
mbed_official 181:a4cbdfbbd2f4 1276 {
mbed_official 181:a4cbdfbbd2f4 1277 UART_HandleTypeDef* huart = (UART_HandleTypeDef*)((DMA_HandleTypeDef*)hdma)->Parent;
mbed_official 181:a4cbdfbbd2f4 1278
mbed_official 181:a4cbdfbbd2f4 1279 HAL_UART_RxHalfCpltCallback(huart);
mbed_official 181:a4cbdfbbd2f4 1280 }
mbed_official 181:a4cbdfbbd2f4 1281
mbed_official 181:a4cbdfbbd2f4 1282 /**
mbed_official 181:a4cbdfbbd2f4 1283 * @brief DMA UART communication error callback
mbed_official 181:a4cbdfbbd2f4 1284 * @param hdma: DMA handle
mbed_official 181:a4cbdfbbd2f4 1285 * @retval None
mbed_official 181:a4cbdfbbd2f4 1286 */
mbed_official 181:a4cbdfbbd2f4 1287 static void UART_DMAError(DMA_HandleTypeDef *hdma)
mbed_official 181:a4cbdfbbd2f4 1288 {
mbed_official 181:a4cbdfbbd2f4 1289 UART_HandleTypeDef* huart = ( UART_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
mbed_official 181:a4cbdfbbd2f4 1290 huart->RxXferCount = 0;
mbed_official 181:a4cbdfbbd2f4 1291 huart->TxXferCount = 0;
mbed_official 181:a4cbdfbbd2f4 1292 huart->State= HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 1293 huart->ErrorCode |= HAL_UART_ERROR_DMA;
mbed_official 181:a4cbdfbbd2f4 1294 HAL_UART_ErrorCallback(huart);
mbed_official 181:a4cbdfbbd2f4 1295 }
mbed_official 181:a4cbdfbbd2f4 1296
mbed_official 181:a4cbdfbbd2f4 1297 /**
mbed_official 181:a4cbdfbbd2f4 1298 * @brief Tx Transfer completed callbacks
mbed_official 181:a4cbdfbbd2f4 1299 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 1300 * @retval None
mbed_official 181:a4cbdfbbd2f4 1301 */
mbed_official 181:a4cbdfbbd2f4 1302 __weak void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1303 {
mbed_official 181:a4cbdfbbd2f4 1304 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 181:a4cbdfbbd2f4 1305 the HAL_UART_TxCpltCallback could be implemented in the user file
mbed_official 181:a4cbdfbbd2f4 1306 */
mbed_official 181:a4cbdfbbd2f4 1307 }
mbed_official 181:a4cbdfbbd2f4 1308
mbed_official 181:a4cbdfbbd2f4 1309 /**
mbed_official 181:a4cbdfbbd2f4 1310 * @brief Tx Half Transfer completed callbacks.
mbed_official 181:a4cbdfbbd2f4 1311 * @param huart: UART handle
mbed_official 181:a4cbdfbbd2f4 1312 * @retval None
mbed_official 181:a4cbdfbbd2f4 1313 */
mbed_official 181:a4cbdfbbd2f4 1314 __weak void HAL_UART_TxHalfCpltCallback(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1315 {
mbed_official 181:a4cbdfbbd2f4 1316 /* NOTE: This function Should not be modified, when the callback is needed,
mbed_official 181:a4cbdfbbd2f4 1317 the HAL_UART_TxCpltCallback could be implemented in the user file
mbed_official 181:a4cbdfbbd2f4 1318 */
mbed_official 181:a4cbdfbbd2f4 1319 }
mbed_official 181:a4cbdfbbd2f4 1320
mbed_official 181:a4cbdfbbd2f4 1321 /**
mbed_official 181:a4cbdfbbd2f4 1322 * @brief Rx Transfer completed callbacks
mbed_official 181:a4cbdfbbd2f4 1323 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 1324 * @retval None
mbed_official 181:a4cbdfbbd2f4 1325 */
mbed_official 181:a4cbdfbbd2f4 1326 __weak void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1327 {
mbed_official 181:a4cbdfbbd2f4 1328 /* NOTE : This function Should not be modified, when the callback is needed,
mbed_official 181:a4cbdfbbd2f4 1329 the HAL_UART_TxCpltCallback could be implemented in the user file
mbed_official 181:a4cbdfbbd2f4 1330 */
mbed_official 181:a4cbdfbbd2f4 1331 }
mbed_official 181:a4cbdfbbd2f4 1332
mbed_official 181:a4cbdfbbd2f4 1333 /**
mbed_official 181:a4cbdfbbd2f4 1334 * @brief Rx Half Transfer completed callbacks.
mbed_official 181:a4cbdfbbd2f4 1335 * @param huart: UART handle
mbed_official 181:a4cbdfbbd2f4 1336 * @retval None
mbed_official 181:a4cbdfbbd2f4 1337 */
mbed_official 181:a4cbdfbbd2f4 1338 __weak void HAL_UART_RxHalfCpltCallback(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1339 {
mbed_official 181:a4cbdfbbd2f4 1340 /* NOTE: This function Should not be modified, when the callback is needed,
mbed_official 181:a4cbdfbbd2f4 1341 the HAL_UART_TxCpltCallback could be implemented in the user file
mbed_official 181:a4cbdfbbd2f4 1342 */
mbed_official 181:a4cbdfbbd2f4 1343 }
mbed_official 181:a4cbdfbbd2f4 1344
mbed_official 181:a4cbdfbbd2f4 1345 /**
mbed_official 181:a4cbdfbbd2f4 1346 * @brief UART error callbacks
mbed_official 181:a4cbdfbbd2f4 1347 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 1348 * @retval None
mbed_official 181:a4cbdfbbd2f4 1349 */
mbed_official 181:a4cbdfbbd2f4 1350 __weak void HAL_UART_ErrorCallback(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1351 {
mbed_official 181:a4cbdfbbd2f4 1352 /* NOTE : This function should not be modified, when the callback is needed,
mbed_official 181:a4cbdfbbd2f4 1353 the HAL_UART_ErrorCallback can be implemented in the user file
mbed_official 181:a4cbdfbbd2f4 1354 */
mbed_official 181:a4cbdfbbd2f4 1355 }
mbed_official 181:a4cbdfbbd2f4 1356
mbed_official 181:a4cbdfbbd2f4 1357 /**
mbed_official 181:a4cbdfbbd2f4 1358 * @brief UART wakeup from Stop mode callback
mbed_official 181:a4cbdfbbd2f4 1359 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 1360 * @retval None
mbed_official 181:a4cbdfbbd2f4 1361 */
mbed_official 181:a4cbdfbbd2f4 1362 __weak void HAL_UART_WakeupCallback(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1363 {
mbed_official 181:a4cbdfbbd2f4 1364 /* NOTE : This function should not be modified, when the callback is needed,
mbed_official 181:a4cbdfbbd2f4 1365 the HAL_UART_WakeupCallback can be implemented in the user file
mbed_official 181:a4cbdfbbd2f4 1366 */
mbed_official 181:a4cbdfbbd2f4 1367 }
mbed_official 181:a4cbdfbbd2f4 1368
mbed_official 181:a4cbdfbbd2f4 1369 /**
mbed_official 181:a4cbdfbbd2f4 1370 * @brief Send an amount of data in interrupt mode
mbed_official 181:a4cbdfbbd2f4 1371 * Function called under interruption only, once
mbed_official 181:a4cbdfbbd2f4 1372 * interruptions have been enabled by HAL_UART_Transmit_IT()
mbed_official 181:a4cbdfbbd2f4 1373 * @param huart: UART handle
mbed_official 181:a4cbdfbbd2f4 1374 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 1375 */
mbed_official 181:a4cbdfbbd2f4 1376 static HAL_StatusTypeDef UART_Transmit_IT(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1377 {
mbed_official 181:a4cbdfbbd2f4 1378 uint16_t* tmp;
mbed_official 181:a4cbdfbbd2f4 1379
mbed_official 181:a4cbdfbbd2f4 1380 if ((huart->State == HAL_UART_STATE_BUSY_TX) || (huart->State == HAL_UART_STATE_BUSY_TX_RX))
mbed_official 181:a4cbdfbbd2f4 1381 {
mbed_official 181:a4cbdfbbd2f4 1382 __HAL_LOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1383
mbed_official 181:a4cbdfbbd2f4 1384 if(huart->TxXferCount == 0)
mbed_official 181:a4cbdfbbd2f4 1385 {
mbed_official 181:a4cbdfbbd2f4 1386 /* Disable the UART Transmit Complete Interrupt */
mbed_official 181:a4cbdfbbd2f4 1387 __HAL_UART_DISABLE_IT(huart, UART_IT_TC);
mbed_official 181:a4cbdfbbd2f4 1388
mbed_official 181:a4cbdfbbd2f4 1389 /* Check if a receive Process is ongoing or not */
mbed_official 181:a4cbdfbbd2f4 1390 if(huart->State == HAL_UART_STATE_BUSY_TX_RX)
mbed_official 181:a4cbdfbbd2f4 1391 {
mbed_official 181:a4cbdfbbd2f4 1392 huart->State = HAL_UART_STATE_BUSY_RX;
mbed_official 181:a4cbdfbbd2f4 1393 }
mbed_official 181:a4cbdfbbd2f4 1394 else
mbed_official 181:a4cbdfbbd2f4 1395 {
mbed_official 181:a4cbdfbbd2f4 1396 /* Disable the UART Parity Error Interrupt */
mbed_official 181:a4cbdfbbd2f4 1397 __HAL_UART_DISABLE_IT(huart, UART_IT_PE);
mbed_official 181:a4cbdfbbd2f4 1398
mbed_official 181:a4cbdfbbd2f4 1399 /* Disable the UART Error Interrupt: (Frame error, noise error, overrun error) */
mbed_official 181:a4cbdfbbd2f4 1400 __HAL_UART_DISABLE_IT(huart, UART_IT_ERR);
mbed_official 181:a4cbdfbbd2f4 1401
mbed_official 181:a4cbdfbbd2f4 1402 huart->State = HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 1403 }
mbed_official 181:a4cbdfbbd2f4 1404 /* Call the Process Unlocked before calling the Tx call back API to give the possibiity to
mbed_official 181:a4cbdfbbd2f4 1405 start again the Transmission under the Tx call back API */
mbed_official 181:a4cbdfbbd2f4 1406 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1407
mbed_official 181:a4cbdfbbd2f4 1408 HAL_UART_TxCpltCallback(huart);
mbed_official 181:a4cbdfbbd2f4 1409
mbed_official 181:a4cbdfbbd2f4 1410 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 1411 }
mbed_official 181:a4cbdfbbd2f4 1412 else
mbed_official 181:a4cbdfbbd2f4 1413 {
mbed_official 181:a4cbdfbbd2f4 1414 if ((huart->Init.WordLength == UART_WORDLENGTH_9B) && (huart->Init.Parity == UART_PARITY_NONE))
mbed_official 181:a4cbdfbbd2f4 1415 {
mbed_official 181:a4cbdfbbd2f4 1416 tmp = (uint16_t*) huart->pTxBuffPtr;
mbed_official 181:a4cbdfbbd2f4 1417 huart->Instance->TDR = (*tmp & (uint16_t)0x01FF);
mbed_official 181:a4cbdfbbd2f4 1418 huart->pTxBuffPtr += 2;
mbed_official 181:a4cbdfbbd2f4 1419 }
mbed_official 181:a4cbdfbbd2f4 1420 else
mbed_official 181:a4cbdfbbd2f4 1421 {
mbed_official 181:a4cbdfbbd2f4 1422 huart->Instance->TDR = (uint8_t)(*huart->pTxBuffPtr++ & (uint8_t)0xFF);
mbed_official 181:a4cbdfbbd2f4 1423 }
mbed_official 181:a4cbdfbbd2f4 1424
mbed_official 181:a4cbdfbbd2f4 1425 huart->TxXferCount--;
mbed_official 181:a4cbdfbbd2f4 1426
mbed_official 181:a4cbdfbbd2f4 1427 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 1428 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1429
mbed_official 181:a4cbdfbbd2f4 1430 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 1431 }
mbed_official 181:a4cbdfbbd2f4 1432 }
mbed_official 181:a4cbdfbbd2f4 1433 else
mbed_official 181:a4cbdfbbd2f4 1434 {
mbed_official 181:a4cbdfbbd2f4 1435 return HAL_BUSY;
mbed_official 181:a4cbdfbbd2f4 1436 }
mbed_official 181:a4cbdfbbd2f4 1437 }
mbed_official 181:a4cbdfbbd2f4 1438
mbed_official 181:a4cbdfbbd2f4 1439 /**
mbed_official 181:a4cbdfbbd2f4 1440 * @brief Receive an amount of data in interrupt mode
mbed_official 181:a4cbdfbbd2f4 1441 * Function called under interruption only, once
mbed_official 181:a4cbdfbbd2f4 1442 * interruptions have been enabled by HAL_UART_Receive_IT()
mbed_official 181:a4cbdfbbd2f4 1443 * @param huart: UART handle
mbed_official 181:a4cbdfbbd2f4 1444 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 1445 */
mbed_official 181:a4cbdfbbd2f4 1446 static HAL_StatusTypeDef UART_Receive_IT(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1447 {
mbed_official 181:a4cbdfbbd2f4 1448 uint16_t* tmp;
mbed_official 181:a4cbdfbbd2f4 1449 uint16_t uhMask = huart->Mask;
mbed_official 181:a4cbdfbbd2f4 1450
mbed_official 181:a4cbdfbbd2f4 1451 if((huart->State == HAL_UART_STATE_BUSY_RX) || (huart->State == HAL_UART_STATE_BUSY_TX_RX))
mbed_official 181:a4cbdfbbd2f4 1452 {
mbed_official 181:a4cbdfbbd2f4 1453 if ((huart->Init.WordLength == UART_WORDLENGTH_9B) && (huart->Init.Parity == UART_PARITY_NONE))
mbed_official 181:a4cbdfbbd2f4 1454 {
mbed_official 181:a4cbdfbbd2f4 1455 tmp = (uint16_t*) huart->pRxBuffPtr ;
mbed_official 181:a4cbdfbbd2f4 1456 *tmp = (uint16_t)(huart->Instance->RDR & uhMask);
mbed_official 181:a4cbdfbbd2f4 1457 huart->pRxBuffPtr +=2;
mbed_official 181:a4cbdfbbd2f4 1458 }
mbed_official 181:a4cbdfbbd2f4 1459 else
mbed_official 181:a4cbdfbbd2f4 1460 {
mbed_official 181:a4cbdfbbd2f4 1461 *huart->pRxBuffPtr++ = (uint8_t)(huart->Instance->RDR & (uint8_t)uhMask);
mbed_official 181:a4cbdfbbd2f4 1462 }
mbed_official 181:a4cbdfbbd2f4 1463
mbed_official 181:a4cbdfbbd2f4 1464 if(--huart->RxXferCount == 0)
mbed_official 181:a4cbdfbbd2f4 1465 {
mbed_official 181:a4cbdfbbd2f4 1466 while(HAL_IS_BIT_SET(huart->Instance->ISR, UART_FLAG_RXNE))
mbed_official 181:a4cbdfbbd2f4 1467 {
mbed_official 181:a4cbdfbbd2f4 1468 }
mbed_official 181:a4cbdfbbd2f4 1469 __HAL_UART_DISABLE_IT(huart, UART_IT_RXNE);
mbed_official 181:a4cbdfbbd2f4 1470
mbed_official 181:a4cbdfbbd2f4 1471 /* Check if a transmit Process is ongoing or not */
mbed_official 181:a4cbdfbbd2f4 1472 if(huart->State == HAL_UART_STATE_BUSY_TX_RX)
mbed_official 181:a4cbdfbbd2f4 1473 {
mbed_official 181:a4cbdfbbd2f4 1474 huart->State = HAL_UART_STATE_BUSY_TX;
mbed_official 181:a4cbdfbbd2f4 1475 }
mbed_official 181:a4cbdfbbd2f4 1476 else
mbed_official 181:a4cbdfbbd2f4 1477 {
mbed_official 181:a4cbdfbbd2f4 1478 /* Disable the UART Parity Error Interrupt */
mbed_official 181:a4cbdfbbd2f4 1479 __HAL_UART_DISABLE_IT(huart, UART_IT_PE);
mbed_official 181:a4cbdfbbd2f4 1480
mbed_official 181:a4cbdfbbd2f4 1481 /* Disable the UART Error Interrupt: (Frame error, noise error, overrun error) */
mbed_official 181:a4cbdfbbd2f4 1482 __HAL_UART_DISABLE_IT(huart, UART_IT_ERR);
mbed_official 181:a4cbdfbbd2f4 1483
mbed_official 181:a4cbdfbbd2f4 1484 huart->State = HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 1485 }
mbed_official 181:a4cbdfbbd2f4 1486 HAL_UART_RxCpltCallback(huart);
mbed_official 181:a4cbdfbbd2f4 1487 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 1488 }
mbed_official 181:a4cbdfbbd2f4 1489 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 1490 }
mbed_official 181:a4cbdfbbd2f4 1491 else
mbed_official 181:a4cbdfbbd2f4 1492 {
mbed_official 181:a4cbdfbbd2f4 1493 return HAL_BUSY;
mbed_official 181:a4cbdfbbd2f4 1494 }
mbed_official 181:a4cbdfbbd2f4 1495 }
mbed_official 181:a4cbdfbbd2f4 1496
mbed_official 181:a4cbdfbbd2f4 1497 /**
mbed_official 181:a4cbdfbbd2f4 1498 * @brief Configure the UART peripheral
mbed_official 181:a4cbdfbbd2f4 1499 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 1500 * @retval None
mbed_official 181:a4cbdfbbd2f4 1501 */
mbed_official 181:a4cbdfbbd2f4 1502 void UART_SetConfig(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1503 {
mbed_official 181:a4cbdfbbd2f4 1504 uint32_t tmpreg = 0x00000000;
mbed_official 181:a4cbdfbbd2f4 1505 uint32_t clocksource = 0x00000000;
mbed_official 181:a4cbdfbbd2f4 1506 uint16_t brrtemp = 0x0000;
mbed_official 181:a4cbdfbbd2f4 1507 uint16_t usartdiv = 0x0000;
mbed_official 181:a4cbdfbbd2f4 1508
mbed_official 181:a4cbdfbbd2f4 1509 /* Check the parameters */
mbed_official 181:a4cbdfbbd2f4 1510 assert_param(IS_UART_BAUDRATE(huart->Init.BaudRate));
mbed_official 181:a4cbdfbbd2f4 1511 assert_param(IS_UART_WORD_LENGTH(huart->Init.WordLength));
mbed_official 181:a4cbdfbbd2f4 1512 assert_param(IS_UART_STOPBITS(huart->Init.StopBits));
mbed_official 181:a4cbdfbbd2f4 1513 assert_param(IS_UART_PARITY(huart->Init.Parity));
mbed_official 181:a4cbdfbbd2f4 1514 assert_param(IS_UART_MODE(huart->Init.Mode));
mbed_official 181:a4cbdfbbd2f4 1515 assert_param(IS_UART_HARDWARE_FLOW_CONTROL(huart->Init.HwFlowCtl));
mbed_official 181:a4cbdfbbd2f4 1516 assert_param(IS_UART_ONEBIT_SAMPLING(huart->Init.OneBitSampling));
mbed_official 181:a4cbdfbbd2f4 1517
mbed_official 181:a4cbdfbbd2f4 1518 /*-------------------------- USART CR1 Configuration -----------------------*/
mbed_official 181:a4cbdfbbd2f4 1519 /* Clear M, PCE, PS, TE, RE and OVER8 bits and configure
mbed_official 181:a4cbdfbbd2f4 1520 * the UART Word Length, Parity, Mode and oversampling:
mbed_official 181:a4cbdfbbd2f4 1521 * set the M bits according to huart->Init.WordLength value
mbed_official 181:a4cbdfbbd2f4 1522 * set PCE and PS bits according to huart->Init.Parity value
mbed_official 181:a4cbdfbbd2f4 1523 * set TE and RE bits according to huart->Init.Mode value
mbed_official 181:a4cbdfbbd2f4 1524 * set OVER8 bit according to huart->Init.OverSampling value */
mbed_official 181:a4cbdfbbd2f4 1525 tmpreg = (uint32_t)huart->Init.WordLength | huart->Init.Parity | huart->Init.Mode | huart->Init.OverSampling ;
mbed_official 181:a4cbdfbbd2f4 1526 MODIFY_REG(huart->Instance->CR1, UART_CR1_FIELDS, tmpreg);
mbed_official 181:a4cbdfbbd2f4 1527
mbed_official 181:a4cbdfbbd2f4 1528 /*-------------------------- USART CR2 Configuration -----------------------*/
mbed_official 181:a4cbdfbbd2f4 1529 /* Configure the UART Stop Bits: Set STOP[13:12] bits according
mbed_official 181:a4cbdfbbd2f4 1530 * to huart->Init.StopBits value */
mbed_official 181:a4cbdfbbd2f4 1531 MODIFY_REG(huart->Instance->CR2, USART_CR2_STOP, huart->Init.StopBits);
mbed_official 181:a4cbdfbbd2f4 1532
mbed_official 181:a4cbdfbbd2f4 1533 /*-------------------------- USART CR3 Configuration -----------------------*/
mbed_official 181:a4cbdfbbd2f4 1534 /* Configure
mbed_official 181:a4cbdfbbd2f4 1535 * - UART HardWare Flow Control: set CTSE and RTSE bits according
mbed_official 181:a4cbdfbbd2f4 1536 * to huart->Init.HwFlowCtl value
mbed_official 181:a4cbdfbbd2f4 1537 * - one-bit sampling method versus three samples' majority rule according
mbed_official 181:a4cbdfbbd2f4 1538 * to huart->Init.OneBitSampling */
mbed_official 181:a4cbdfbbd2f4 1539 tmpreg = (uint32_t)huart->Init.HwFlowCtl | huart->Init.OneBitSampling ;
mbed_official 181:a4cbdfbbd2f4 1540 MODIFY_REG(huart->Instance->CR3, (USART_CR3_RTSE | USART_CR3_CTSE | USART_CR3_ONEBIT), tmpreg);
mbed_official 181:a4cbdfbbd2f4 1541
mbed_official 181:a4cbdfbbd2f4 1542 /*-------------------------- USART BRR Configuration -----------------------*/
mbed_official 181:a4cbdfbbd2f4 1543 __HAL_UART_GETCLOCKSOURCE(huart, clocksource);
mbed_official 181:a4cbdfbbd2f4 1544
mbed_official 181:a4cbdfbbd2f4 1545 /* Check LPUART instace */
mbed_official 181:a4cbdfbbd2f4 1546 if(huart->Instance == LPUART1)
mbed_official 181:a4cbdfbbd2f4 1547 {
mbed_official 181:a4cbdfbbd2f4 1548 switch (clocksource)
mbed_official 181:a4cbdfbbd2f4 1549 {
mbed_official 181:a4cbdfbbd2f4 1550 case UART_CLOCKSOURCE_PCLK1:
mbed_official 181:a4cbdfbbd2f4 1551 huart->Instance->BRR = (uint32_t)(__DIV_LPUART(HAL_RCC_GetPCLK1Freq(), huart->Init.BaudRate));
mbed_official 181:a4cbdfbbd2f4 1552 break;
mbed_official 181:a4cbdfbbd2f4 1553 case UART_CLOCKSOURCE_HSI:
mbed_official 181:a4cbdfbbd2f4 1554 huart->Instance->BRR = (uint32_t)(__DIV_LPUART(HSI_VALUE, huart->Init.BaudRate));
mbed_official 181:a4cbdfbbd2f4 1555 break;
mbed_official 181:a4cbdfbbd2f4 1556 case UART_CLOCKSOURCE_SYSCLK:
mbed_official 181:a4cbdfbbd2f4 1557 huart->Instance->BRR = (uint32_t)(__DIV_LPUART(HAL_RCC_GetSysClockFreq(), huart->Init.BaudRate));
mbed_official 181:a4cbdfbbd2f4 1558 break;
mbed_official 181:a4cbdfbbd2f4 1559 case UART_CLOCKSOURCE_LSE:
mbed_official 181:a4cbdfbbd2f4 1560 huart->Instance->BRR = (uint32_t)(__DIV_LPUART(LSE_VALUE, huart->Init.BaudRate));
mbed_official 181:a4cbdfbbd2f4 1561 break;
mbed_official 181:a4cbdfbbd2f4 1562 default:
mbed_official 181:a4cbdfbbd2f4 1563 break;
mbed_official 181:a4cbdfbbd2f4 1564 }
mbed_official 181:a4cbdfbbd2f4 1565 }
mbed_official 181:a4cbdfbbd2f4 1566 /* Check the UART Over Sampling 8 to set Baud Rate Register */
mbed_official 181:a4cbdfbbd2f4 1567 else if (huart->Init.OverSampling == UART_OVERSAMPLING_8)
mbed_official 181:a4cbdfbbd2f4 1568 {
mbed_official 181:a4cbdfbbd2f4 1569 switch (clocksource)
mbed_official 181:a4cbdfbbd2f4 1570 {
mbed_official 181:a4cbdfbbd2f4 1571 case UART_CLOCKSOURCE_PCLK1:
mbed_official 181:a4cbdfbbd2f4 1572 usartdiv = (uint32_t)(__DIV_SAMPLING8(HAL_RCC_GetPCLK1Freq(), huart->Init.BaudRate));
mbed_official 181:a4cbdfbbd2f4 1573 break;
mbed_official 181:a4cbdfbbd2f4 1574 case UART_CLOCKSOURCE_PCLK2:
mbed_official 181:a4cbdfbbd2f4 1575 usartdiv = (uint32_t)(__DIV_SAMPLING8(HAL_RCC_GetPCLK2Freq(), huart->Init.BaudRate));
mbed_official 181:a4cbdfbbd2f4 1576 break;
mbed_official 181:a4cbdfbbd2f4 1577 case UART_CLOCKSOURCE_HSI:
mbed_official 181:a4cbdfbbd2f4 1578 usartdiv = (uint32_t)(__DIV_SAMPLING8(HSI_VALUE, huart->Init.BaudRate));
mbed_official 181:a4cbdfbbd2f4 1579 break;
mbed_official 181:a4cbdfbbd2f4 1580 case UART_CLOCKSOURCE_SYSCLK:
mbed_official 181:a4cbdfbbd2f4 1581 huart->Instance->BRR = (uint32_t)(__DIV_SAMPLING8(HAL_RCC_GetSysClockFreq(), huart->Init.BaudRate));
mbed_official 181:a4cbdfbbd2f4 1582 break;
mbed_official 181:a4cbdfbbd2f4 1583 case UART_CLOCKSOURCE_LSE:
mbed_official 181:a4cbdfbbd2f4 1584 usartdiv = (uint32_t)(__DIV_SAMPLING8(LSE_VALUE, huart->Init.BaudRate));
mbed_official 181:a4cbdfbbd2f4 1585 break;
mbed_official 181:a4cbdfbbd2f4 1586 default:
mbed_official 181:a4cbdfbbd2f4 1587 break;
mbed_official 181:a4cbdfbbd2f4 1588 }
mbed_official 181:a4cbdfbbd2f4 1589
mbed_official 181:a4cbdfbbd2f4 1590 brrtemp = usartdiv & 0xFFF0;
mbed_official 181:a4cbdfbbd2f4 1591 brrtemp |= (uint16_t)((uint16_t)(usartdiv & (uint16_t)0x000F) >> (uint16_t)1);
mbed_official 181:a4cbdfbbd2f4 1592 huart->Instance->BRR = brrtemp;
mbed_official 181:a4cbdfbbd2f4 1593 }
mbed_official 181:a4cbdfbbd2f4 1594 else
mbed_official 181:a4cbdfbbd2f4 1595 {
mbed_official 181:a4cbdfbbd2f4 1596 switch (clocksource)
mbed_official 181:a4cbdfbbd2f4 1597 {
mbed_official 181:a4cbdfbbd2f4 1598 case UART_CLOCKSOURCE_PCLK1:
mbed_official 181:a4cbdfbbd2f4 1599 huart->Instance->BRR = (uint32_t)(__DIV_SAMPLING16(HAL_RCC_GetPCLK1Freq(), huart->Init.BaudRate));
mbed_official 181:a4cbdfbbd2f4 1600 break;
mbed_official 181:a4cbdfbbd2f4 1601 case UART_CLOCKSOURCE_PCLK2:
mbed_official 181:a4cbdfbbd2f4 1602 huart->Instance->BRR = (uint32_t)(__DIV_SAMPLING16(HAL_RCC_GetPCLK2Freq(), huart->Init.BaudRate));
mbed_official 181:a4cbdfbbd2f4 1603 break;
mbed_official 181:a4cbdfbbd2f4 1604 case UART_CLOCKSOURCE_HSI:
mbed_official 181:a4cbdfbbd2f4 1605 huart->Instance->BRR = (uint32_t)(__DIV_SAMPLING16(HSI_VALUE, huart->Init.BaudRate));
mbed_official 181:a4cbdfbbd2f4 1606 break;
mbed_official 181:a4cbdfbbd2f4 1607 case UART_CLOCKSOURCE_SYSCLK:
mbed_official 181:a4cbdfbbd2f4 1608 huart->Instance->BRR = (uint32_t)(__DIV_SAMPLING16(HAL_RCC_GetSysClockFreq(), huart->Init.BaudRate));
mbed_official 181:a4cbdfbbd2f4 1609 break;
mbed_official 181:a4cbdfbbd2f4 1610 case UART_CLOCKSOURCE_LSE:
mbed_official 181:a4cbdfbbd2f4 1611 huart->Instance->BRR = (uint32_t)(__DIV_SAMPLING16(LSE_VALUE, huart->Init.BaudRate));
mbed_official 181:a4cbdfbbd2f4 1612 break;
mbed_official 181:a4cbdfbbd2f4 1613 default:
mbed_official 181:a4cbdfbbd2f4 1614 break;
mbed_official 181:a4cbdfbbd2f4 1615 }
mbed_official 181:a4cbdfbbd2f4 1616 }
mbed_official 181:a4cbdfbbd2f4 1617 }
mbed_official 181:a4cbdfbbd2f4 1618
mbed_official 181:a4cbdfbbd2f4 1619 /**
mbed_official 181:a4cbdfbbd2f4 1620 * @brief Check the UART Idle State
mbed_official 181:a4cbdfbbd2f4 1621 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 1622 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 1623 */
mbed_official 181:a4cbdfbbd2f4 1624 HAL_StatusTypeDef UART_CheckIdleState(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1625 {
mbed_official 181:a4cbdfbbd2f4 1626 /* Check if the Transmitter is enabled */
mbed_official 181:a4cbdfbbd2f4 1627 if((huart->Instance->CR1 & USART_CR1_TE) == USART_CR1_TE)
mbed_official 181:a4cbdfbbd2f4 1628 {
mbed_official 181:a4cbdfbbd2f4 1629 /* Wait until TEACK flag is set */
mbed_official 181:a4cbdfbbd2f4 1630 if(UART_WaitOnFlagUntilTimeout(huart, USART_ISR_TEACK, RESET, UART_TIMEOUT_VALUE) != HAL_OK)
mbed_official 181:a4cbdfbbd2f4 1631 {
mbed_official 181:a4cbdfbbd2f4 1632 return HAL_TIMEOUT;
mbed_official 181:a4cbdfbbd2f4 1633 }
mbed_official 181:a4cbdfbbd2f4 1634 }
mbed_official 181:a4cbdfbbd2f4 1635 /* Check if the Receiver is enabled */
mbed_official 181:a4cbdfbbd2f4 1636 if((huart->Instance->CR1 & USART_CR1_RE) == USART_CR1_RE)
mbed_official 181:a4cbdfbbd2f4 1637 {
mbed_official 181:a4cbdfbbd2f4 1638 /* Wait until REACK flag is set */
mbed_official 181:a4cbdfbbd2f4 1639 if(UART_WaitOnFlagUntilTimeout(huart, USART_ISR_REACK, RESET, UART_TIMEOUT_VALUE) != HAL_OK)
mbed_official 181:a4cbdfbbd2f4 1640 {
mbed_official 181:a4cbdfbbd2f4 1641 return HAL_TIMEOUT;
mbed_official 181:a4cbdfbbd2f4 1642 }
mbed_official 181:a4cbdfbbd2f4 1643 }
mbed_official 181:a4cbdfbbd2f4 1644
mbed_official 181:a4cbdfbbd2f4 1645 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 1646 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1647
mbed_official 181:a4cbdfbbd2f4 1648 /* Initialize the UART state*/
mbed_official 181:a4cbdfbbd2f4 1649 huart->ErrorCode = HAL_UART_ERROR_NONE;
mbed_official 181:a4cbdfbbd2f4 1650 huart->State= HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 1651
mbed_official 181:a4cbdfbbd2f4 1652 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 1653 }
mbed_official 181:a4cbdfbbd2f4 1654
mbed_official 181:a4cbdfbbd2f4 1655 /**
mbed_official 181:a4cbdfbbd2f4 1656 * @brief Configure the UART peripheral advanced feautures
mbed_official 181:a4cbdfbbd2f4 1657 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 1658 * @retval None
mbed_official 181:a4cbdfbbd2f4 1659 */
mbed_official 181:a4cbdfbbd2f4 1660 void UART_AdvFeatureConfig(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1661 {
mbed_official 181:a4cbdfbbd2f4 1662 /* Check whether the set of advanced features to configure is properly set */
mbed_official 181:a4cbdfbbd2f4 1663 assert_param(IS_UART_ADVFEATURE_INIT(huart->AdvancedInit.AdvFeatureInit));
mbed_official 181:a4cbdfbbd2f4 1664
mbed_official 181:a4cbdfbbd2f4 1665 /* if required, configure TX pin active level inversion */
mbed_official 181:a4cbdfbbd2f4 1666 if(HAL_IS_BIT_SET(huart->AdvancedInit.AdvFeatureInit, UART_ADVFEATURE_TXINVERT_INIT))
mbed_official 181:a4cbdfbbd2f4 1667 {
mbed_official 181:a4cbdfbbd2f4 1668 assert_param(IS_UART_ADVFEATURE_TXINV(huart->AdvancedInit.TxPinLevelInvert));
mbed_official 181:a4cbdfbbd2f4 1669 MODIFY_REG(huart->Instance->CR2, USART_CR2_TXINV, huart->AdvancedInit.TxPinLevelInvert);
mbed_official 181:a4cbdfbbd2f4 1670 }
mbed_official 181:a4cbdfbbd2f4 1671
mbed_official 181:a4cbdfbbd2f4 1672 /* if required, configure RX pin active level inversion */
mbed_official 181:a4cbdfbbd2f4 1673 if(HAL_IS_BIT_SET(huart->AdvancedInit.AdvFeatureInit, UART_ADVFEATURE_RXINVERT_INIT))
mbed_official 181:a4cbdfbbd2f4 1674 {
mbed_official 181:a4cbdfbbd2f4 1675 assert_param(IS_UART_ADVFEATURE_RXINV(huart->AdvancedInit.RxPinLevelInvert));
mbed_official 181:a4cbdfbbd2f4 1676 MODIFY_REG(huart->Instance->CR2, USART_CR2_RXINV, huart->AdvancedInit.RxPinLevelInvert);
mbed_official 181:a4cbdfbbd2f4 1677 }
mbed_official 181:a4cbdfbbd2f4 1678
mbed_official 181:a4cbdfbbd2f4 1679 /* if required, configure data inversion */
mbed_official 181:a4cbdfbbd2f4 1680 if(HAL_IS_BIT_SET(huart->AdvancedInit.AdvFeatureInit, UART_ADVFEATURE_DATAINVERT_INIT))
mbed_official 181:a4cbdfbbd2f4 1681 {
mbed_official 181:a4cbdfbbd2f4 1682 assert_param(IS_UART_ADVFEATURE_DATAINV(huart->AdvancedInit.DataInvert));
mbed_official 181:a4cbdfbbd2f4 1683 MODIFY_REG(huart->Instance->CR2, USART_CR2_DATAINV, huart->AdvancedInit.DataInvert);
mbed_official 181:a4cbdfbbd2f4 1684 }
mbed_official 181:a4cbdfbbd2f4 1685
mbed_official 181:a4cbdfbbd2f4 1686 /* if required, configure RX/TX pins swap */
mbed_official 181:a4cbdfbbd2f4 1687 if(HAL_IS_BIT_SET(huart->AdvancedInit.AdvFeatureInit, UART_ADVFEATURE_SWAP_INIT))
mbed_official 181:a4cbdfbbd2f4 1688 {
mbed_official 181:a4cbdfbbd2f4 1689 assert_param(IS_UART_ADVFEATURE_SWAP(huart->AdvancedInit.Swap));
mbed_official 181:a4cbdfbbd2f4 1690 MODIFY_REG(huart->Instance->CR2, USART_CR2_SWAP, huart->AdvancedInit.Swap);
mbed_official 181:a4cbdfbbd2f4 1691 }
mbed_official 181:a4cbdfbbd2f4 1692
mbed_official 181:a4cbdfbbd2f4 1693 /* if required, configure RX overrun detection disabling */
mbed_official 181:a4cbdfbbd2f4 1694 if(HAL_IS_BIT_SET(huart->AdvancedInit.AdvFeatureInit, UART_ADVFEATURE_RXOVERRUNDISABLE_INIT))
mbed_official 181:a4cbdfbbd2f4 1695 {
mbed_official 181:a4cbdfbbd2f4 1696 assert_param(IS_UART_OVERRUN(huart->AdvancedInit.OverrunDisable));
mbed_official 181:a4cbdfbbd2f4 1697 MODIFY_REG(huart->Instance->CR3, USART_CR3_OVRDIS, huart->AdvancedInit.OverrunDisable);
mbed_official 181:a4cbdfbbd2f4 1698 }
mbed_official 181:a4cbdfbbd2f4 1699
mbed_official 181:a4cbdfbbd2f4 1700 /* if required, configure DMA disabling on reception error */
mbed_official 181:a4cbdfbbd2f4 1701 if(HAL_IS_BIT_SET(huart->AdvancedInit.AdvFeatureInit, UART_ADVFEATURE_DMADISABLEONERROR_INIT))
mbed_official 181:a4cbdfbbd2f4 1702 {
mbed_official 181:a4cbdfbbd2f4 1703 assert_param(IS_UART_ADVFEATURE_DMAONRXERROR(huart->AdvancedInit.DMADisableonRxError));
mbed_official 181:a4cbdfbbd2f4 1704 MODIFY_REG(huart->Instance->CR3, USART_CR3_DDRE, huart->AdvancedInit.DMADisableonRxError);
mbed_official 181:a4cbdfbbd2f4 1705 }
mbed_official 181:a4cbdfbbd2f4 1706
mbed_official 181:a4cbdfbbd2f4 1707 /* if required, configure auto Baud rate detection scheme */
mbed_official 181:a4cbdfbbd2f4 1708 if(HAL_IS_BIT_SET(huart->AdvancedInit.AdvFeatureInit, UART_ADVFEATURE_AUTOBAUDRATE_INIT))
mbed_official 181:a4cbdfbbd2f4 1709 {
mbed_official 181:a4cbdfbbd2f4 1710 assert_param(IS_UART_ADVFEATURE_AUTOBAUDRATE(huart->AdvancedInit.AutoBaudRateEnable));
mbed_official 181:a4cbdfbbd2f4 1711 MODIFY_REG(huart->Instance->CR2, USART_CR2_ABREN, huart->AdvancedInit.AutoBaudRateEnable);
mbed_official 181:a4cbdfbbd2f4 1712 /* set auto Baudrate detection parameters if detection is enabled */
mbed_official 181:a4cbdfbbd2f4 1713 if(huart->AdvancedInit.AutoBaudRateEnable == UART_ADVFEATURE_AUTOBAUDRATE_ENABLE)
mbed_official 181:a4cbdfbbd2f4 1714 {
mbed_official 181:a4cbdfbbd2f4 1715 assert_param(IS_UART_ADVFEATURE_AUTOBAUDRATEMODE(huart->AdvancedInit.AutoBaudRateMode));
mbed_official 181:a4cbdfbbd2f4 1716 MODIFY_REG(huart->Instance->CR2, USART_CR2_ABRMODE, huart->AdvancedInit.AutoBaudRateMode);
mbed_official 181:a4cbdfbbd2f4 1717 }
mbed_official 181:a4cbdfbbd2f4 1718 }
mbed_official 181:a4cbdfbbd2f4 1719
mbed_official 181:a4cbdfbbd2f4 1720 /* if required, configure MSB first on communication line */
mbed_official 181:a4cbdfbbd2f4 1721 if(HAL_IS_BIT_SET(huart->AdvancedInit.AdvFeatureInit, UART_ADVFEATURE_MSBFIRST_INIT))
mbed_official 181:a4cbdfbbd2f4 1722 {
mbed_official 181:a4cbdfbbd2f4 1723 assert_param(IS_UART_ADVFEATURE_MSBFIRST(huart->AdvancedInit.MSBFirst));
mbed_official 181:a4cbdfbbd2f4 1724 MODIFY_REG(huart->Instance->CR2, USART_CR2_MSBFIRST, huart->AdvancedInit.MSBFirst);
mbed_official 181:a4cbdfbbd2f4 1725 }
mbed_official 181:a4cbdfbbd2f4 1726 }
mbed_official 181:a4cbdfbbd2f4 1727
mbed_official 181:a4cbdfbbd2f4 1728 /**
mbed_official 181:a4cbdfbbd2f4 1729 * @brief This function handles UART Communication Timeout.
mbed_official 181:a4cbdfbbd2f4 1730 * @param huart: UART handle
mbed_official 181:a4cbdfbbd2f4 1731 * @param Flag: specifies the UART flag to check.
mbed_official 181:a4cbdfbbd2f4 1732 * @param Status: The new Flag status (SET or RESET).
mbed_official 181:a4cbdfbbd2f4 1733 * @param Timeout: Timeout duration
mbed_official 181:a4cbdfbbd2f4 1734 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 1735 */
mbed_official 181:a4cbdfbbd2f4 1736 HAL_StatusTypeDef UART_WaitOnFlagUntilTimeout(UART_HandleTypeDef *huart, uint32_t Flag, FlagStatus Status, uint32_t Timeout)
mbed_official 181:a4cbdfbbd2f4 1737 {
mbed_official 181:a4cbdfbbd2f4 1738 uint32_t tickstart = 0x00;
mbed_official 181:a4cbdfbbd2f4 1739 tickstart = HAL_GetTick();
mbed_official 181:a4cbdfbbd2f4 1740
mbed_official 181:a4cbdfbbd2f4 1741 /* Wait until flag is set */
mbed_official 181:a4cbdfbbd2f4 1742 if(Status == RESET)
mbed_official 181:a4cbdfbbd2f4 1743 {
mbed_official 181:a4cbdfbbd2f4 1744 while(__HAL_UART_GET_FLAG(huart, Flag) == RESET)
mbed_official 181:a4cbdfbbd2f4 1745 {
mbed_official 181:a4cbdfbbd2f4 1746 /* Check for the Timeout */
mbed_official 181:a4cbdfbbd2f4 1747 if(Timeout != HAL_MAX_DELAY)
mbed_official 181:a4cbdfbbd2f4 1748 {
mbed_official 181:a4cbdfbbd2f4 1749 if((HAL_GetTick() - tickstart ) > Timeout)
mbed_official 181:a4cbdfbbd2f4 1750 {
mbed_official 181:a4cbdfbbd2f4 1751 /* Disable TXE, RXNE, PE and ERR (Frame error, noise error, overrun error) interrupts for the interrupt process */
mbed_official 181:a4cbdfbbd2f4 1752 __HAL_UART_DISABLE_IT(huart, UART_IT_TXE);
mbed_official 181:a4cbdfbbd2f4 1753 __HAL_UART_DISABLE_IT(huart, UART_IT_RXNE);
mbed_official 181:a4cbdfbbd2f4 1754 __HAL_UART_DISABLE_IT(huart, UART_IT_PE);
mbed_official 181:a4cbdfbbd2f4 1755 __HAL_UART_DISABLE_IT(huart, UART_IT_ERR);
mbed_official 181:a4cbdfbbd2f4 1756
mbed_official 181:a4cbdfbbd2f4 1757 huart->State= HAL_UART_STATE_TIMEOUT;
mbed_official 181:a4cbdfbbd2f4 1758
mbed_official 181:a4cbdfbbd2f4 1759 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 1760 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1761
mbed_official 181:a4cbdfbbd2f4 1762 return HAL_TIMEOUT;
mbed_official 181:a4cbdfbbd2f4 1763 }
mbed_official 181:a4cbdfbbd2f4 1764 }
mbed_official 181:a4cbdfbbd2f4 1765 }
mbed_official 181:a4cbdfbbd2f4 1766 }
mbed_official 181:a4cbdfbbd2f4 1767 else
mbed_official 181:a4cbdfbbd2f4 1768 {
mbed_official 181:a4cbdfbbd2f4 1769 while(__HAL_UART_GET_FLAG(huart, Flag) != RESET)
mbed_official 181:a4cbdfbbd2f4 1770 {
mbed_official 181:a4cbdfbbd2f4 1771 /* Check for the Timeout */
mbed_official 181:a4cbdfbbd2f4 1772 if(Timeout != HAL_MAX_DELAY)
mbed_official 181:a4cbdfbbd2f4 1773 {
mbed_official 181:a4cbdfbbd2f4 1774 if((HAL_GetTick() - tickstart ) > Timeout)
mbed_official 181:a4cbdfbbd2f4 1775 {
mbed_official 181:a4cbdfbbd2f4 1776 /* Disable TXE, RXNE, PE and ERR (Frame error, noise error, overrun error) interrupts for the interrupt process */
mbed_official 181:a4cbdfbbd2f4 1777 __HAL_UART_DISABLE_IT(huart, UART_IT_TXE);
mbed_official 181:a4cbdfbbd2f4 1778 __HAL_UART_DISABLE_IT(huart, UART_IT_RXNE);
mbed_official 181:a4cbdfbbd2f4 1779 __HAL_UART_DISABLE_IT(huart, UART_IT_PE);
mbed_official 181:a4cbdfbbd2f4 1780 __HAL_UART_DISABLE_IT(huart, UART_IT_ERR);
mbed_official 181:a4cbdfbbd2f4 1781
mbed_official 181:a4cbdfbbd2f4 1782 huart->State= HAL_UART_STATE_TIMEOUT;
mbed_official 181:a4cbdfbbd2f4 1783
mbed_official 181:a4cbdfbbd2f4 1784 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 1785 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1786
mbed_official 181:a4cbdfbbd2f4 1787 return HAL_TIMEOUT;
mbed_official 181:a4cbdfbbd2f4 1788 }
mbed_official 181:a4cbdfbbd2f4 1789 }
mbed_official 181:a4cbdfbbd2f4 1790 }
mbed_official 181:a4cbdfbbd2f4 1791 }
mbed_official 181:a4cbdfbbd2f4 1792 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 1793 }
mbed_official 181:a4cbdfbbd2f4 1794
mbed_official 181:a4cbdfbbd2f4 1795 /**
mbed_official 181:a4cbdfbbd2f4 1796 * @}
mbed_official 181:a4cbdfbbd2f4 1797 */
mbed_official 181:a4cbdfbbd2f4 1798
mbed_official 181:a4cbdfbbd2f4 1799 /** @defgroup HAL_UART_Group3 Peripheral Control methods
mbed_official 181:a4cbdfbbd2f4 1800 * @brief UART control functions
mbed_official 181:a4cbdfbbd2f4 1801 *
mbed_official 181:a4cbdfbbd2f4 1802 @verbatim
mbed_official 181:a4cbdfbbd2f4 1803 ===============================================================================
mbed_official 181:a4cbdfbbd2f4 1804 ##### Peripheral Control methods #####
mbed_official 181:a4cbdfbbd2f4 1805 ===============================================================================
mbed_official 181:a4cbdfbbd2f4 1806 [..]
mbed_official 181:a4cbdfbbd2f4 1807 This subsection provides a set of functions allowing to control the UART.
mbed_official 181:a4cbdfbbd2f4 1808 (+) HAL_MultiProcessor_EnableMuteMode() API enables mute mode
mbed_official 181:a4cbdfbbd2f4 1809 (+) HAL_MultiProcessor_DisableMuteMode() API disables mute mode
mbed_official 181:a4cbdfbbd2f4 1810 (+) HAL_MultiProcessor_EnterMuteMode() API enters mute mode
mbed_official 181:a4cbdfbbd2f4 1811 (+) HAL_HalfDuplex_EnableTransmitter() API enables the transmitter
mbed_official 181:a4cbdfbbd2f4 1812 (+) HAL_HalfDuplex_EnableReceiver() API enables the receiver
mbed_official 181:a4cbdfbbd2f4 1813 (+) HAL_UART_GetState() API is helpful to check in run-time the state of the UART peripheral
mbed_official 181:a4cbdfbbd2f4 1814 (+) HAL_UART_GetError()API is helpful to check in run-time the error state of the UART peripheral
mbed_official 181:a4cbdfbbd2f4 1815 @endverbatim
mbed_official 181:a4cbdfbbd2f4 1816 * @{
mbed_official 181:a4cbdfbbd2f4 1817 */
mbed_official 181:a4cbdfbbd2f4 1818
mbed_official 181:a4cbdfbbd2f4 1819 /**
mbed_official 181:a4cbdfbbd2f4 1820 * @brief Enable UART in mute mode (doesn't mean UART enters mute mode;
mbed_official 181:a4cbdfbbd2f4 1821 * to enter mute mode, HAL_MultiProcessor_EnterMuteMode() API must be called)
mbed_official 181:a4cbdfbbd2f4 1822 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 1823 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 1824 */
mbed_official 181:a4cbdfbbd2f4 1825 HAL_StatusTypeDef HAL_MultiProcessor_EnableMuteMode(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1826 {
mbed_official 181:a4cbdfbbd2f4 1827 /* Process Locked */
mbed_official 181:a4cbdfbbd2f4 1828 __HAL_LOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1829
mbed_official 181:a4cbdfbbd2f4 1830 huart->State = HAL_UART_STATE_BUSY;
mbed_official 181:a4cbdfbbd2f4 1831
mbed_official 181:a4cbdfbbd2f4 1832 /* Enable USART mute mode by setting the MME bit in the CR1 register */
mbed_official 181:a4cbdfbbd2f4 1833 huart->Instance->CR1 |= USART_CR1_MME;
mbed_official 181:a4cbdfbbd2f4 1834
mbed_official 181:a4cbdfbbd2f4 1835 huart->State = HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 1836
mbed_official 181:a4cbdfbbd2f4 1837 return (UART_CheckIdleState(huart));
mbed_official 181:a4cbdfbbd2f4 1838 }
mbed_official 181:a4cbdfbbd2f4 1839
mbed_official 181:a4cbdfbbd2f4 1840 /**
mbed_official 181:a4cbdfbbd2f4 1841 * @brief Disable UART mute mode (doesn't mean it actually wakes up the software,
mbed_official 181:a4cbdfbbd2f4 1842 * as it may not have been in mute mode at this very moment).
mbed_official 181:a4cbdfbbd2f4 1843 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 1844 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 1845 */
mbed_official 181:a4cbdfbbd2f4 1846 HAL_StatusTypeDef HAL_MultiProcessor_DisableMuteMode(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1847 {
mbed_official 181:a4cbdfbbd2f4 1848 /* Process Locked */
mbed_official 181:a4cbdfbbd2f4 1849 __HAL_LOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1850
mbed_official 181:a4cbdfbbd2f4 1851 huart->State = HAL_UART_STATE_BUSY;
mbed_official 181:a4cbdfbbd2f4 1852
mbed_official 181:a4cbdfbbd2f4 1853 /* Disable USART mute mode by clearing the MME bit in the CR1 register */
mbed_official 181:a4cbdfbbd2f4 1854 huart->Instance->CR1 &= ~(USART_CR1_MME);
mbed_official 181:a4cbdfbbd2f4 1855
mbed_official 181:a4cbdfbbd2f4 1856 huart->State = HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 1857
mbed_official 181:a4cbdfbbd2f4 1858 return (UART_CheckIdleState(huart));
mbed_official 181:a4cbdfbbd2f4 1859 }
mbed_official 181:a4cbdfbbd2f4 1860
mbed_official 181:a4cbdfbbd2f4 1861 /**
mbed_official 181:a4cbdfbbd2f4 1862 * @brief Enter UART mute mode (means UART actually enters mute mode).
mbed_official 181:a4cbdfbbd2f4 1863 * To exit from mute mode, HAL_MultiProcessor_DisableMuteMode() API must be called.
mbed_official 181:a4cbdfbbd2f4 1864 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 1865 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 1866 */
mbed_official 181:a4cbdfbbd2f4 1867 void HAL_MultiProcessor_EnterMuteMode(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1868 {
mbed_official 181:a4cbdfbbd2f4 1869 __HAL_UART_SEND_REQ(huart, UART_MUTE_MODE_REQUEST);
mbed_official 181:a4cbdfbbd2f4 1870 }
mbed_official 181:a4cbdfbbd2f4 1871
mbed_official 181:a4cbdfbbd2f4 1872 /**
mbed_official 181:a4cbdfbbd2f4 1873 * @brief Enables the UART transmitter and disables the UART receiver.
mbed_official 181:a4cbdfbbd2f4 1874 * @param huart: UART handle
mbed_official 181:a4cbdfbbd2f4 1875 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 1876 * @retval None
mbed_official 181:a4cbdfbbd2f4 1877 */
mbed_official 181:a4cbdfbbd2f4 1878 HAL_StatusTypeDef HAL_HalfDuplex_EnableTransmitter(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1879 {
mbed_official 181:a4cbdfbbd2f4 1880 /* Process Locked */
mbed_official 181:a4cbdfbbd2f4 1881 __HAL_LOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1882 huart->State = HAL_UART_STATE_BUSY;
mbed_official 181:a4cbdfbbd2f4 1883
mbed_official 181:a4cbdfbbd2f4 1884 /* Clear TE and RE bits */
mbed_official 181:a4cbdfbbd2f4 1885 CLEAR_BIT(huart->Instance->CR1, (USART_CR1_TE | USART_CR1_RE));
mbed_official 181:a4cbdfbbd2f4 1886 /* Enable the USART's transmit interface by setting the TE bit in the USART CR1 register */
mbed_official 181:a4cbdfbbd2f4 1887 SET_BIT(huart->Instance->CR1, USART_CR1_TE);
mbed_official 181:a4cbdfbbd2f4 1888
mbed_official 181:a4cbdfbbd2f4 1889 huart->State = HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 1890 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 1891 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1892
mbed_official 181:a4cbdfbbd2f4 1893 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 1894 }
mbed_official 181:a4cbdfbbd2f4 1895
mbed_official 181:a4cbdfbbd2f4 1896 /**
mbed_official 181:a4cbdfbbd2f4 1897 * @brief Enables the UART receiver and disables the UART transmitter.
mbed_official 181:a4cbdfbbd2f4 1898 * @param huart: UART handle
mbed_official 181:a4cbdfbbd2f4 1899 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 1900 */
mbed_official 181:a4cbdfbbd2f4 1901 HAL_StatusTypeDef HAL_HalfDuplex_EnableReceiver(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1902 {
mbed_official 181:a4cbdfbbd2f4 1903 /* Process Locked */
mbed_official 181:a4cbdfbbd2f4 1904 __HAL_LOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1905 huart->State = HAL_UART_STATE_BUSY;
mbed_official 181:a4cbdfbbd2f4 1906
mbed_official 181:a4cbdfbbd2f4 1907 /* Clear TE and RE bits */
mbed_official 181:a4cbdfbbd2f4 1908 CLEAR_BIT(huart->Instance->CR1, (USART_CR1_TE | USART_CR1_RE));
mbed_official 181:a4cbdfbbd2f4 1909 /* Enable the USART's receive interface by setting the RE bit in the USART CR1 register */
mbed_official 181:a4cbdfbbd2f4 1910 SET_BIT(huart->Instance->CR1, USART_CR1_RE);
mbed_official 181:a4cbdfbbd2f4 1911
mbed_official 181:a4cbdfbbd2f4 1912 huart->State = HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 1913 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 1914 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1915
mbed_official 181:a4cbdfbbd2f4 1916 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 1917 }
mbed_official 181:a4cbdfbbd2f4 1918
mbed_official 181:a4cbdfbbd2f4 1919 /**
mbed_official 181:a4cbdfbbd2f4 1920 * @brief Transmits break characters.
mbed_official 181:a4cbdfbbd2f4 1921 * @param huart: pointer to a UART_HandleTypeDef structure that contains
mbed_official 181:a4cbdfbbd2f4 1922 * the configuration information for the specified UART module.
mbed_official 181:a4cbdfbbd2f4 1923 * @retval HAL status
mbed_official 181:a4cbdfbbd2f4 1924 */
mbed_official 181:a4cbdfbbd2f4 1925 HAL_StatusTypeDef HAL_LIN_SendBreak(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1926 {
mbed_official 181:a4cbdfbbd2f4 1927 /* Check the parameters */
mbed_official 181:a4cbdfbbd2f4 1928 assert_param(IS_UART_INSTANCE(huart->Instance));
mbed_official 181:a4cbdfbbd2f4 1929
mbed_official 181:a4cbdfbbd2f4 1930 /* Process Locked */
mbed_official 181:a4cbdfbbd2f4 1931 __HAL_LOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1932
mbed_official 181:a4cbdfbbd2f4 1933 huart->State = HAL_UART_STATE_BUSY;
mbed_official 181:a4cbdfbbd2f4 1934
mbed_official 181:a4cbdfbbd2f4 1935 /* Send break characters */
mbed_official 181:a4cbdfbbd2f4 1936 huart->Instance->RQR |= USART_RQR_SBKRQ;
mbed_official 181:a4cbdfbbd2f4 1937
mbed_official 181:a4cbdfbbd2f4 1938 huart->State = HAL_UART_STATE_READY;
mbed_official 181:a4cbdfbbd2f4 1939
mbed_official 181:a4cbdfbbd2f4 1940 /* Process Unlocked */
mbed_official 181:a4cbdfbbd2f4 1941 __HAL_UNLOCK(huart);
mbed_official 181:a4cbdfbbd2f4 1942
mbed_official 181:a4cbdfbbd2f4 1943 return HAL_OK;
mbed_official 181:a4cbdfbbd2f4 1944 }
mbed_official 181:a4cbdfbbd2f4 1945
mbed_official 181:a4cbdfbbd2f4 1946 /**
mbed_official 181:a4cbdfbbd2f4 1947 * @brief return the UART state
mbed_official 181:a4cbdfbbd2f4 1948 * @param huart: uart handle
mbed_official 181:a4cbdfbbd2f4 1949 * @retval HAL state
mbed_official 181:a4cbdfbbd2f4 1950 */
mbed_official 181:a4cbdfbbd2f4 1951 HAL_UART_StateTypeDef HAL_UART_GetState(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1952 {
mbed_official 181:a4cbdfbbd2f4 1953 return huart->State;
mbed_official 181:a4cbdfbbd2f4 1954 }
mbed_official 181:a4cbdfbbd2f4 1955
mbed_official 181:a4cbdfbbd2f4 1956 /**
mbed_official 181:a4cbdfbbd2f4 1957 * @brief Return the UART error code
mbed_official 181:a4cbdfbbd2f4 1958 * @param huart : pointer to a UART_HandleTypeDef structure that contains
mbed_official 181:a4cbdfbbd2f4 1959 * the configuration information for the specified UART.
mbed_official 181:a4cbdfbbd2f4 1960 * @retval UART Error Code
mbed_official 181:a4cbdfbbd2f4 1961 */
mbed_official 181:a4cbdfbbd2f4 1962 uint32_t HAL_UART_GetError(UART_HandleTypeDef *huart)
mbed_official 181:a4cbdfbbd2f4 1963 {
mbed_official 181:a4cbdfbbd2f4 1964 return huart->ErrorCode;
mbed_official 181:a4cbdfbbd2f4 1965 }
mbed_official 181:a4cbdfbbd2f4 1966
mbed_official 181:a4cbdfbbd2f4 1967 /**
mbed_official 181:a4cbdfbbd2f4 1968 * @}
mbed_official 181:a4cbdfbbd2f4 1969 */
mbed_official 181:a4cbdfbbd2f4 1970
mbed_official 181:a4cbdfbbd2f4 1971 /**
mbed_official 181:a4cbdfbbd2f4 1972 * @}
mbed_official 181:a4cbdfbbd2f4 1973 */
mbed_official 181:a4cbdfbbd2f4 1974
mbed_official 181:a4cbdfbbd2f4 1975 #endif /* HAL_UART_MODULE_ENABLED */
mbed_official 181:a4cbdfbbd2f4 1976 /**
mbed_official 181:a4cbdfbbd2f4 1977 * @}
mbed_official 181:a4cbdfbbd2f4 1978 */
mbed_official 181:a4cbdfbbd2f4 1979
mbed_official 181:a4cbdfbbd2f4 1980 /**
mbed_official 181:a4cbdfbbd2f4 1981 * @}
mbed_official 181:a4cbdfbbd2f4 1982 */
mbed_official 181:a4cbdfbbd2f4 1983
mbed_official 181:a4cbdfbbd2f4 1984 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/