Tux Leon / mbed-dev

mbed library sources. Supersedes mbed-src.

Fork of mbed-dev by mbed official

targets/TARGET_STM/TARGET_STM32L4/device/stm32l4xx_hal_uart_ex.c@181:96ed750bd169, 2018-01-17 (annotated)

Committer:
Anna Bridge
Date:
Wed Jan 17 15:23:54 2018 +0000
Revision:
181:96ed750bd169
Parent:
167:e84263d55307 
mbed-dev libray. Release version 158

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 144:ef7eb2e8f9f7 1 /**
<> 144:ef7eb2e8f9f7 2 ******************************************************************************
<> 144:ef7eb2e8f9f7 3 * @file stm32l4xx_hal_uart_ex.c
<> 144:ef7eb2e8f9f7 4 * @author MCD Application Team
AnnaBridge 167:e84263d55307 5 * @version V1.7.1
AnnaBridge 167:e84263d55307 6 * @date 21-April-2017
<> 144:ef7eb2e8f9f7 7 * @brief Extended UART HAL module driver.
<> 144:ef7eb2e8f9f7 8 * This file provides firmware functions to manage the following extended
<> 144:ef7eb2e8f9f7 9 * functionalities of the Universal Asynchronous Receiver Transmitter Peripheral (UART).
<> 144:ef7eb2e8f9f7 10 * + Initialization and de-initialization functions
<> 144:ef7eb2e8f9f7 11 * + Peripheral Control functions
<> 144:ef7eb2e8f9f7 12 *
<> 144:ef7eb2e8f9f7 13 *
<> 144:ef7eb2e8f9f7 14 @verbatim
<> 144:ef7eb2e8f9f7 15 ==============================================================================
<> 144:ef7eb2e8f9f7 16 ##### UART peripheral extended features #####
<> 144:ef7eb2e8f9f7 17 ==============================================================================
<> 144:ef7eb2e8f9f7 18
<> 144:ef7eb2e8f9f7 19 (#) Declare a UART_HandleTypeDef handle structure.
<> 144:ef7eb2e8f9f7 20
<> 144:ef7eb2e8f9f7 21 (#) For the UART RS485 Driver Enable mode, initialize the UART registers
<> 144:ef7eb2e8f9f7 22 by calling the HAL_RS485Ex_Init() API.
<> 144:ef7eb2e8f9f7 23
<> 144:ef7eb2e8f9f7 24
<> 144:ef7eb2e8f9f7 25 @endverbatim
<> 144:ef7eb2e8f9f7 26 ******************************************************************************
<> 144:ef7eb2e8f9f7 27 * @attention
<> 144:ef7eb2e8f9f7 28 *
AnnaBridge 167:e84263d55307 29 * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
<> 144:ef7eb2e8f9f7 30 *
<> 144:ef7eb2e8f9f7 31 * Redistribution and use in source and binary forms, with or without modification,
<> 144:ef7eb2e8f9f7 32 * are permitted provided that the following conditions are met:
<> 144:ef7eb2e8f9f7 33 * 1. Redistributions of source code must retain the above copyright notice,
<> 144:ef7eb2e8f9f7 34 * this list of conditions and the following disclaimer.
<> 144:ef7eb2e8f9f7 35 * 2. Redistributions in binary form must reproduce the above copyright notice,
<> 144:ef7eb2e8f9f7 36 * this list of conditions and the following disclaimer in the documentation
<> 144:ef7eb2e8f9f7 37 * and/or other materials provided with the distribution.
<> 144:ef7eb2e8f9f7 38 * 3. Neither the name of STMicroelectronics nor the names of its contributors
<> 144:ef7eb2e8f9f7 39 * may be used to endorse or promote products derived from this software
<> 144:ef7eb2e8f9f7 40 * without specific prior written permission.
<> 144:ef7eb2e8f9f7 41 *
<> 144:ef7eb2e8f9f7 42 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
<> 144:ef7eb2e8f9f7 43 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
<> 144:ef7eb2e8f9f7 44 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
<> 144:ef7eb2e8f9f7 45 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
<> 144:ef7eb2e8f9f7 46 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
<> 144:ef7eb2e8f9f7 47 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
<> 144:ef7eb2e8f9f7 48 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
<> 144:ef7eb2e8f9f7 49 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
<> 144:ef7eb2e8f9f7 50 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
<> 144:ef7eb2e8f9f7 51 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<> 144:ef7eb2e8f9f7 52 *
<> 144:ef7eb2e8f9f7 53 ******************************************************************************
<> 144:ef7eb2e8f9f7 54 */
<> 144:ef7eb2e8f9f7 55
<> 144:ef7eb2e8f9f7 56 /* Includes ------------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 57 #include "stm32l4xx_hal.h"
<> 144:ef7eb2e8f9f7 58
<> 144:ef7eb2e8f9f7 59 /** @addtogroup STM32L4xx_HAL_Driver
<> 144:ef7eb2e8f9f7 60 * @{
<> 144:ef7eb2e8f9f7 61 */
<> 144:ef7eb2e8f9f7 62
<> 144:ef7eb2e8f9f7 63 /** @defgroup UARTEx UARTEx
<> 144:ef7eb2e8f9f7 64 * @brief UART Extended HAL module driver
<> 144:ef7eb2e8f9f7 65 * @{
<> 144:ef7eb2e8f9f7 66 */
<> 144:ef7eb2e8f9f7 67
<> 144:ef7eb2e8f9f7 68 #ifdef HAL_UART_MODULE_ENABLED
<> 144:ef7eb2e8f9f7 69
<> 144:ef7eb2e8f9f7 70 /* Private typedef -----------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 71 /* Private define ------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 72 /* Private macros ------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 73 /* Private variables ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 74 /* Private function prototypes -----------------------------------------------*/
<> 144:ef7eb2e8f9f7 75 /** @defgroup UARTEx_Private_Functions UARTEx Private Functions
<> 144:ef7eb2e8f9f7 76 * @{
<> 144:ef7eb2e8f9f7 77 */
<> 144:ef7eb2e8f9f7 78 static void UARTEx_Wakeup_AddressConfig(UART_HandleTypeDef *huart, UART_WakeUpTypeDef WakeUpSelection);
<> 144:ef7eb2e8f9f7 79 /**
<> 144:ef7eb2e8f9f7 80 * @}
<> 144:ef7eb2e8f9f7 81 */
<> 144:ef7eb2e8f9f7 82
<> 144:ef7eb2e8f9f7 83 /* Exported functions --------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 84
<> 144:ef7eb2e8f9f7 85 /** @defgroup UARTEx_Exported_Functions UARTEx Exported Functions
<> 144:ef7eb2e8f9f7 86 * @{
<> 144:ef7eb2e8f9f7 87 */
<> 144:ef7eb2e8f9f7 88
<> 144:ef7eb2e8f9f7 89 /** @defgroup UARTEx_Exported_Functions_Group1 Initialization and de-initialization functions
<> 144:ef7eb2e8f9f7 90 * @brief Extended Initialization and Configuration Functions
<> 144:ef7eb2e8f9f7 91 *
<> 144:ef7eb2e8f9f7 92 @verbatim
<> 144:ef7eb2e8f9f7 93 ===============================================================================
<> 144:ef7eb2e8f9f7 94 ##### Initialization and Configuration functions #####
<> 144:ef7eb2e8f9f7 95 ===============================================================================
<> 144:ef7eb2e8f9f7 96 [..]
<> 144:ef7eb2e8f9f7 97 This subsection provides a set of functions allowing to initialize the USARTx or the UARTy
<> 144:ef7eb2e8f9f7 98 in asynchronous mode.
<> 144:ef7eb2e8f9f7 99 (+) For the asynchronous mode the parameters below can be configured:
<> 144:ef7eb2e8f9f7 100 (++) Baud Rate
<> 144:ef7eb2e8f9f7 101 (++) Word Length
<> 144:ef7eb2e8f9f7 102 (++) Stop Bit
<> 144:ef7eb2e8f9f7 103 (++) Parity: If the parity is enabled, then the MSB bit of the data written
<> 144:ef7eb2e8f9f7 104 in the data register is transmitted but is changed by the parity bit.
<> 144:ef7eb2e8f9f7 105 (++) Hardware flow control
<> 144:ef7eb2e8f9f7 106 (++) Receiver/transmitter modes
<> 144:ef7eb2e8f9f7 107 (++) Over Sampling Method
<> 144:ef7eb2e8f9f7 108 (++) One-Bit Sampling Method
<> 144:ef7eb2e8f9f7 109 (+) For the asynchronous mode, the following advanced features can be configured as well:
<> 144:ef7eb2e8f9f7 110 (++) TX and/or RX pin level inversion
<> 144:ef7eb2e8f9f7 111 (++) data logical level inversion
<> 144:ef7eb2e8f9f7 112 (++) RX and TX pins swap
<> 144:ef7eb2e8f9f7 113 (++) RX overrun detection disabling
<> 144:ef7eb2e8f9f7 114 (++) DMA disabling on RX error
<> 144:ef7eb2e8f9f7 115 (++) MSB first on communication line
<> 144:ef7eb2e8f9f7 116 (++) auto Baud rate detection
<> 144:ef7eb2e8f9f7 117 [..]
<> 144:ef7eb2e8f9f7 118 The HAL_RS485Ex_Init() API follows the UART RS485 mode configuration
<> 144:ef7eb2e8f9f7 119 procedures (details for the procedures are available in reference manual).
<> 144:ef7eb2e8f9f7 120
<> 144:ef7eb2e8f9f7 121 @endverbatim
<> 144:ef7eb2e8f9f7 122
<> 144:ef7eb2e8f9f7 123 Depending on the frame length defined by the M1 and M0 bits (7-bit,
<> 144:ef7eb2e8f9f7 124 8-bit or 9-bit), the possible UART formats are listed in the
<> 144:ef7eb2e8f9f7 125 following table.
<> 144:ef7eb2e8f9f7 126
<> 144:ef7eb2e8f9f7 127 Table 1. UART frame format.
<> 144:ef7eb2e8f9f7 128 +-----------------------------------------------------------------------+
<> 144:ef7eb2e8f9f7 129 | M1 bit | M0 bit | PCE bit | UART frame |
<> 144:ef7eb2e8f9f7 130 |---------|---------|-----------|---------------------------------------|
<> 144:ef7eb2e8f9f7 131 | 0 | 0 | 0 | | SB | 8 bit data | STB | |
<> 144:ef7eb2e8f9f7 132 |---------|---------|-----------|---------------------------------------|
<> 144:ef7eb2e8f9f7 133 | 0 | 0 | 1 | | SB | 7 bit data | PB | STB | |
<> 144:ef7eb2e8f9f7 134 |---------|---------|-----------|---------------------------------------|
<> 144:ef7eb2e8f9f7 135 | 0 | 1 | 0 | | SB | 9 bit data | STB | |
<> 144:ef7eb2e8f9f7 136 |---------|---------|-----------|---------------------------------------|
<> 144:ef7eb2e8f9f7 137 | 0 | 1 | 1 | | SB | 8 bit data | PB | STB | |
<> 144:ef7eb2e8f9f7 138 |---------|---------|-----------|---------------------------------------|
<> 144:ef7eb2e8f9f7 139 | 1 | 0 | 0 | | SB | 7 bit data | STB | |
<> 144:ef7eb2e8f9f7 140 |---------|---------|-----------|---------------------------------------|
<> 144:ef7eb2e8f9f7 141 | 1 | 0 | 1 | | SB | 6 bit data | PB | STB | |
<> 144:ef7eb2e8f9f7 142 +-----------------------------------------------------------------------+
<> 144:ef7eb2e8f9f7 143
<> 144:ef7eb2e8f9f7 144 * @{
<> 144:ef7eb2e8f9f7 145 */
<> 144:ef7eb2e8f9f7 146
<> 144:ef7eb2e8f9f7 147 /**
<> 144:ef7eb2e8f9f7 148 * @brief Initialize the RS485 Driver enable feature according to the specified
<> 144:ef7eb2e8f9f7 149 * parameters in the UART_InitTypeDef and creates the associated handle.
<> 144:ef7eb2e8f9f7 150 * @param huart: UART handle.
<> 144:ef7eb2e8f9f7 151 * @param Polarity: select the driver enable polarity.
<> 144:ef7eb2e8f9f7 152 * This parameter can be one of the following values:
<> 144:ef7eb2e8f9f7 153 * @arg @ref UART_DE_POLARITY_HIGH DE signal is active high
<> 144:ef7eb2e8f9f7 154 * @arg @ref UART_DE_POLARITY_LOW DE signal is active low
<> 144:ef7eb2e8f9f7 155 * @param AssertionTime: Driver Enable assertion time:
<> 144:ef7eb2e8f9f7 156 * 5-bit value defining the time between the activation of the DE (Driver Enable)
<> 144:ef7eb2e8f9f7 157 * signal and the beginning of the start bit. It is expressed in sample time
<> 144:ef7eb2e8f9f7 158 * units (1/8 or 1/16 bit time, depending on the oversampling rate)
<> 144:ef7eb2e8f9f7 159 * @param DeassertionTime: Driver Enable deassertion time:
<> 144:ef7eb2e8f9f7 160 * 5-bit value defining the time between the end of the last stop bit, in a
<> 144:ef7eb2e8f9f7 161 * transmitted message, and the de-activation of the DE (Driver Enable) signal.
<> 144:ef7eb2e8f9f7 162 * It is expressed in sample time units (1/8 or 1/16 bit time, depending on the
<> 144:ef7eb2e8f9f7 163 * oversampling rate).
<> 144:ef7eb2e8f9f7 164 * @retval HAL status
<> 144:ef7eb2e8f9f7 165 */
<> 144:ef7eb2e8f9f7 166 HAL_StatusTypeDef HAL_RS485Ex_Init(UART_HandleTypeDef *huart, uint32_t Polarity, uint32_t AssertionTime, uint32_t DeassertionTime)
<> 144:ef7eb2e8f9f7 167 {
<> 144:ef7eb2e8f9f7 168 uint32_t temp = 0x0;
<> 144:ef7eb2e8f9f7 169
<> 144:ef7eb2e8f9f7 170 /* Check the UART handle allocation */
<> 144:ef7eb2e8f9f7 171 if(huart == NULL)
<> 144:ef7eb2e8f9f7 172 {
<> 144:ef7eb2e8f9f7 173 return HAL_ERROR;
<> 144:ef7eb2e8f9f7 174 }
<> 144:ef7eb2e8f9f7 175 /* Check the Driver Enable UART instance */
<> 144:ef7eb2e8f9f7 176 assert_param(IS_UART_DRIVER_ENABLE_INSTANCE(huart->Instance));
<> 144:ef7eb2e8f9f7 177
<> 144:ef7eb2e8f9f7 178 /* Check the Driver Enable polarity */
<> 144:ef7eb2e8f9f7 179 assert_param(IS_UART_DE_POLARITY(Polarity));
<> 144:ef7eb2e8f9f7 180
<> 144:ef7eb2e8f9f7 181 /* Check the Driver Enable assertion time */
<> 144:ef7eb2e8f9f7 182 assert_param(IS_UART_ASSERTIONTIME(AssertionTime));
<> 144:ef7eb2e8f9f7 183
<> 144:ef7eb2e8f9f7 184 /* Check the Driver Enable deassertion time */
<> 144:ef7eb2e8f9f7 185 assert_param(IS_UART_DEASSERTIONTIME(DeassertionTime));
<> 144:ef7eb2e8f9f7 186
<> 144:ef7eb2e8f9f7 187 if(huart->gState == HAL_UART_STATE_RESET)
<> 144:ef7eb2e8f9f7 188 {
<> 144:ef7eb2e8f9f7 189 /* Allocate lock resource and initialize it */
<> 144:ef7eb2e8f9f7 190 huart->Lock = HAL_UNLOCKED;
<> 144:ef7eb2e8f9f7 191
<> 144:ef7eb2e8f9f7 192 /* Init the low level hardware : GPIO, CLOCK, CORTEX */
<> 144:ef7eb2e8f9f7 193 HAL_UART_MspInit(huart);
<> 144:ef7eb2e8f9f7 194 }
<> 144:ef7eb2e8f9f7 195
<> 144:ef7eb2e8f9f7 196 huart->gState = HAL_UART_STATE_BUSY;
<> 144:ef7eb2e8f9f7 197
<> 144:ef7eb2e8f9f7 198 /* Disable the Peripheral */
<> 144:ef7eb2e8f9f7 199 __HAL_UART_DISABLE(huart);
<> 144:ef7eb2e8f9f7 200
<> 144:ef7eb2e8f9f7 201 /* Set the UART Communication parameters */
<> 144:ef7eb2e8f9f7 202 if (UART_SetConfig(huart) == HAL_ERROR)
<> 144:ef7eb2e8f9f7 203 {
<> 144:ef7eb2e8f9f7 204 return HAL_ERROR;
<> 144:ef7eb2e8f9f7 205 }
<> 144:ef7eb2e8f9f7 206
<> 144:ef7eb2e8f9f7 207 if(huart->AdvancedInit.AdvFeatureInit != UART_ADVFEATURE_NO_INIT)
<> 144:ef7eb2e8f9f7 208 {
<> 144:ef7eb2e8f9f7 209 UART_AdvFeatureConfig(huart);
<> 144:ef7eb2e8f9f7 210 }
<> 144:ef7eb2e8f9f7 211
<> 144:ef7eb2e8f9f7 212 /* Enable the Driver Enable mode by setting the DEM bit in the CR3 register */
<> 144:ef7eb2e8f9f7 213 SET_BIT(huart->Instance->CR3, USART_CR3_DEM);
<> 144:ef7eb2e8f9f7 214
<> 144:ef7eb2e8f9f7 215 /* Set the Driver Enable polarity */
<> 144:ef7eb2e8f9f7 216 MODIFY_REG(huart->Instance->CR3, USART_CR3_DEP, Polarity);
<> 144:ef7eb2e8f9f7 217
<> 144:ef7eb2e8f9f7 218 /* Set the Driver Enable assertion and deassertion times */
<> 144:ef7eb2e8f9f7 219 temp = (AssertionTime << UART_CR1_DEAT_ADDRESS_LSB_POS);
<> 144:ef7eb2e8f9f7 220 temp |= (DeassertionTime << UART_CR1_DEDT_ADDRESS_LSB_POS);
<> 144:ef7eb2e8f9f7 221 MODIFY_REG(huart->Instance->CR1, (USART_CR1_DEDT|USART_CR1_DEAT), temp);
<> 144:ef7eb2e8f9f7 222
<> 144:ef7eb2e8f9f7 223 /* Enable the Peripheral */
<> 144:ef7eb2e8f9f7 224 __HAL_UART_ENABLE(huart);
<> 144:ef7eb2e8f9f7 225
<> 144:ef7eb2e8f9f7 226 /* TEACK and/or REACK to check before moving huart->gState and huart->RxState to Ready */
<> 144:ef7eb2e8f9f7 227 return (UART_CheckIdleState(huart));
<> 144:ef7eb2e8f9f7 228 }
<> 144:ef7eb2e8f9f7 229
<> 144:ef7eb2e8f9f7 230
<> 144:ef7eb2e8f9f7 231 /**
<> 144:ef7eb2e8f9f7 232 * @}
<> 144:ef7eb2e8f9f7 233 */
<> 144:ef7eb2e8f9f7 234
<> 144:ef7eb2e8f9f7 235 /** @defgroup UARTEx_Exported_Functions_Group3 Peripheral Control functions
<> 144:ef7eb2e8f9f7 236 * @brief Extended Peripheral Control functions
<> 144:ef7eb2e8f9f7 237 *
<> 144:ef7eb2e8f9f7 238 @verbatim
<> 144:ef7eb2e8f9f7 239 ===============================================================================
<> 144:ef7eb2e8f9f7 240 ##### Peripheral Control functions #####
<> 144:ef7eb2e8f9f7 241 ===============================================================================
<> 144:ef7eb2e8f9f7 242 [..] This section provides the following functions:
<> 144:ef7eb2e8f9f7 243 (+) HAL_UARTEx_EnableClockStopMode() API enables the UART clock (HSI or LSE only) during stop mode
<> 144:ef7eb2e8f9f7 244 (+) HAL_UARTEx_DisableClockStopMode() API disables the above functionality
<> 144:ef7eb2e8f9f7 245 (+) HAL_MultiProcessorEx_AddressLength_Set() API optionally sets the UART node address
<> 144:ef7eb2e8f9f7 246 detection length to more than 4 bits for multiprocessor address mark wake up.
<> 144:ef7eb2e8f9f7 247 (+) HAL_UARTEx_StopModeWakeUpSourceConfig() API defines the wake-up from stop mode
<> 144:ef7eb2e8f9f7 248 trigger: address match, Start Bit detection or RXNE bit status.
<> 144:ef7eb2e8f9f7 249 (+) HAL_UARTEx_EnableStopMode() API enables the UART to wake up the MCU from stop mode
<> 144:ef7eb2e8f9f7 250 (+) HAL_UARTEx_DisableStopMode() API disables the above functionality
<> 144:ef7eb2e8f9f7 251 (+) HAL_UARTEx_WakeupCallback() called upon UART wakeup interrupt
<> 144:ef7eb2e8f9f7 252
<> 144:ef7eb2e8f9f7 253
<> 144:ef7eb2e8f9f7 254 @endverbatim
<> 144:ef7eb2e8f9f7 255 * @{
<> 144:ef7eb2e8f9f7 256 */
<> 144:ef7eb2e8f9f7 257
<> 144:ef7eb2e8f9f7 258
<> 144:ef7eb2e8f9f7 259
<> 144:ef7eb2e8f9f7 260
<> 144:ef7eb2e8f9f7 261 /**
<> 144:ef7eb2e8f9f7 262 * @brief By default in multiprocessor mode, when the wake up method is set
<> 144:ef7eb2e8f9f7 263 * to address mark, the UART handles only 4-bit long addresses detection;
<> 144:ef7eb2e8f9f7 264 * this API allows to enable longer addresses detection (6-, 7- or 8-bit
<> 144:ef7eb2e8f9f7 265 * long).
<> 144:ef7eb2e8f9f7 266 * @note Addresses detection lengths are: 6-bit address detection in 7-bit data mode,
<> 144:ef7eb2e8f9f7 267 * 7-bit address detection in 8-bit data mode, 8-bit address detection in 9-bit data mode.
<> 144:ef7eb2e8f9f7 268 * @param huart: UART handle.
<> 144:ef7eb2e8f9f7 269 * @param AddressLength: this parameter can be one of the following values:
<> 144:ef7eb2e8f9f7 270 * @arg @ref UART_ADDRESS_DETECT_4B 4-bit long address
<> 144:ef7eb2e8f9f7 271 * @arg @ref UART_ADDRESS_DETECT_7B 6-, 7- or 8-bit long address
<> 144:ef7eb2e8f9f7 272 * @retval HAL status
<> 144:ef7eb2e8f9f7 273 */
<> 144:ef7eb2e8f9f7 274 HAL_StatusTypeDef HAL_MultiProcessorEx_AddressLength_Set(UART_HandleTypeDef *huart, uint32_t AddressLength)
<> 144:ef7eb2e8f9f7 275 {
<> 144:ef7eb2e8f9f7 276 /* Check the UART handle allocation */
<> 144:ef7eb2e8f9f7 277 if(huart == NULL)
<> 144:ef7eb2e8f9f7 278 {
<> 144:ef7eb2e8f9f7 279 return HAL_ERROR;
<> 144:ef7eb2e8f9f7 280 }
<> 144:ef7eb2e8f9f7 281
<> 144:ef7eb2e8f9f7 282 /* Check the address length parameter */
<> 144:ef7eb2e8f9f7 283 assert_param(IS_UART_ADDRESSLENGTH_DETECT(AddressLength));
<> 144:ef7eb2e8f9f7 284
<> 144:ef7eb2e8f9f7 285 huart->gState = HAL_UART_STATE_BUSY;
<> 144:ef7eb2e8f9f7 286
<> 144:ef7eb2e8f9f7 287 /* Disable the Peripheral */
<> 144:ef7eb2e8f9f7 288 __HAL_UART_DISABLE(huart);
<> 144:ef7eb2e8f9f7 289
<> 144:ef7eb2e8f9f7 290 /* Set the address length */
<> 144:ef7eb2e8f9f7 291 MODIFY_REG(huart->Instance->CR2, USART_CR2_ADDM7, AddressLength);
<> 144:ef7eb2e8f9f7 292
<> 144:ef7eb2e8f9f7 293 /* Enable the Peripheral */
<> 144:ef7eb2e8f9f7 294 __HAL_UART_ENABLE(huart);
<> 144:ef7eb2e8f9f7 295
<> 144:ef7eb2e8f9f7 296 /* TEACK and/or REACK to check before moving huart->gState to Ready */
<> 144:ef7eb2e8f9f7 297 return (UART_CheckIdleState(huart));
<> 144:ef7eb2e8f9f7 298 }
<> 144:ef7eb2e8f9f7 299
<> 144:ef7eb2e8f9f7 300
<> 144:ef7eb2e8f9f7 301 /**
<> 144:ef7eb2e8f9f7 302 * @brief Set Wakeup from Stop mode interrupt flag selection.
<> 144:ef7eb2e8f9f7 303 * @param huart: UART handle.
<> 144:ef7eb2e8f9f7 304 * @param WakeUpSelection: address match, Start Bit detection or RXNE bit status.
<> 144:ef7eb2e8f9f7 305 * This parameter can be one of the following values:
<> 144:ef7eb2e8f9f7 306 * @arg @ref UART_WAKEUP_ON_ADDRESS
<> 144:ef7eb2e8f9f7 307 * @arg @ref UART_WAKEUP_ON_STARTBIT
<> 144:ef7eb2e8f9f7 308 * @arg @ref UART_WAKEUP_ON_READDATA_NONEMPTY
<> 144:ef7eb2e8f9f7 309 * @retval HAL status
<> 144:ef7eb2e8f9f7 310 */
<> 144:ef7eb2e8f9f7 311 HAL_StatusTypeDef HAL_UARTEx_StopModeWakeUpSourceConfig(UART_HandleTypeDef *huart, UART_WakeUpTypeDef WakeUpSelection)
<> 144:ef7eb2e8f9f7 312 {
<> 144:ef7eb2e8f9f7 313 HAL_StatusTypeDef status = HAL_OK;
<> 144:ef7eb2e8f9f7 314 uint32_t tickstart = 0;
<> 144:ef7eb2e8f9f7 315
<> 144:ef7eb2e8f9f7 316 /* check the wake-up from stop mode UART instance */
<> 144:ef7eb2e8f9f7 317 assert_param(IS_UART_WAKEUP_FROMSTOP_INSTANCE(huart->Instance));
<> 144:ef7eb2e8f9f7 318 /* check the wake-up selection parameter */
<> 144:ef7eb2e8f9f7 319 assert_param(IS_UART_WAKEUP_SELECTION(WakeUpSelection.WakeUpEvent));
<> 144:ef7eb2e8f9f7 320
<> 144:ef7eb2e8f9f7 321 /* Process Locked */
<> 144:ef7eb2e8f9f7 322 __HAL_LOCK(huart);
<> 144:ef7eb2e8f9f7 323
<> 144:ef7eb2e8f9f7 324 huart->gState = HAL_UART_STATE_BUSY;
<> 144:ef7eb2e8f9f7 325
<> 144:ef7eb2e8f9f7 326 /* Disable the Peripheral */
<> 144:ef7eb2e8f9f7 327 __HAL_UART_DISABLE(huart);
<> 144:ef7eb2e8f9f7 328
<> 144:ef7eb2e8f9f7 329 /* Set the wake-up selection scheme */
<> 144:ef7eb2e8f9f7 330 MODIFY_REG(huart->Instance->CR3, USART_CR3_WUS, WakeUpSelection.WakeUpEvent);
<> 144:ef7eb2e8f9f7 331
<> 144:ef7eb2e8f9f7 332 if (WakeUpSelection.WakeUpEvent == UART_WAKEUP_ON_ADDRESS)
<> 144:ef7eb2e8f9f7 333 {
<> 144:ef7eb2e8f9f7 334 UARTEx_Wakeup_AddressConfig(huart, WakeUpSelection);
<> 144:ef7eb2e8f9f7 335 }
<> 144:ef7eb2e8f9f7 336
<> 144:ef7eb2e8f9f7 337 /* Enable the Peripheral */
<> 144:ef7eb2e8f9f7 338 __HAL_UART_ENABLE(huart);
<> 144:ef7eb2e8f9f7 339
<> 144:ef7eb2e8f9f7 340 /* Init tickstart for timeout managment*/
<> 144:ef7eb2e8f9f7 341 tickstart = HAL_GetTick();
<> 144:ef7eb2e8f9f7 342
<> 144:ef7eb2e8f9f7 343 /* Wait until REACK flag is set */
<> 144:ef7eb2e8f9f7 344 if(UART_WaitOnFlagUntilTimeout(huart, USART_ISR_REACK, RESET, tickstart, HAL_UART_TIMEOUT_VALUE) != HAL_OK)
<> 144:ef7eb2e8f9f7 345 {
<> 144:ef7eb2e8f9f7 346 status = HAL_TIMEOUT;
<> 144:ef7eb2e8f9f7 347 }
<> 144:ef7eb2e8f9f7 348 else
<> 144:ef7eb2e8f9f7 349 {
<> 144:ef7eb2e8f9f7 350 /* Initialize the UART State */
<> 144:ef7eb2e8f9f7 351 huart->gState = HAL_UART_STATE_READY;
<> 144:ef7eb2e8f9f7 352 }
<> 144:ef7eb2e8f9f7 353
<> 144:ef7eb2e8f9f7 354 /* Process Unlocked */
<> 144:ef7eb2e8f9f7 355 __HAL_UNLOCK(huart);
<> 144:ef7eb2e8f9f7 356
<> 144:ef7eb2e8f9f7 357 return status;
<> 144:ef7eb2e8f9f7 358 }
<> 144:ef7eb2e8f9f7 359
<> 144:ef7eb2e8f9f7 360
<> 144:ef7eb2e8f9f7 361 /**
<> 144:ef7eb2e8f9f7 362 * @brief Enable UART Stop Mode.
<> 144:ef7eb2e8f9f7 363 * @note The UART is able to wake up the MCU from Stop 1 mode as long as UART clock is HSI or LSE.
<> 144:ef7eb2e8f9f7 364 * @param huart: UART handle.
<> 144:ef7eb2e8f9f7 365 * @retval HAL status
<> 144:ef7eb2e8f9f7 366 */
<> 144:ef7eb2e8f9f7 367 HAL_StatusTypeDef HAL_UARTEx_EnableStopMode(UART_HandleTypeDef *huart)
<> 144:ef7eb2e8f9f7 368 {
<> 144:ef7eb2e8f9f7 369 /* Process Locked */
<> 144:ef7eb2e8f9f7 370 __HAL_LOCK(huart);
<> 144:ef7eb2e8f9f7 371
<> 144:ef7eb2e8f9f7 372 huart->gState = HAL_UART_STATE_BUSY;
<> 144:ef7eb2e8f9f7 373
<> 144:ef7eb2e8f9f7 374 /* Set UESM bit */
<> 144:ef7eb2e8f9f7 375 SET_BIT(huart->Instance->CR1, USART_CR1_UESM);
<> 144:ef7eb2e8f9f7 376
<> 144:ef7eb2e8f9f7 377 huart->gState = HAL_UART_STATE_READY;
<> 144:ef7eb2e8f9f7 378
<> 144:ef7eb2e8f9f7 379 /* Process Unlocked */
<> 144:ef7eb2e8f9f7 380 __HAL_UNLOCK(huart);
<> 144:ef7eb2e8f9f7 381
<> 144:ef7eb2e8f9f7 382 return HAL_OK;
<> 144:ef7eb2e8f9f7 383 }
<> 144:ef7eb2e8f9f7 384
<> 144:ef7eb2e8f9f7 385 /**
<> 144:ef7eb2e8f9f7 386 * @brief Disable UART Stop Mode.
<> 144:ef7eb2e8f9f7 387 * @param huart: UART handle.
<> 144:ef7eb2e8f9f7 388 * @retval HAL status
<> 144:ef7eb2e8f9f7 389 */
<> 144:ef7eb2e8f9f7 390 HAL_StatusTypeDef HAL_UARTEx_DisableStopMode(UART_HandleTypeDef *huart)
<> 144:ef7eb2e8f9f7 391 {
<> 144:ef7eb2e8f9f7 392 /* Process Locked */
<> 144:ef7eb2e8f9f7 393 __HAL_LOCK(huart);
<> 144:ef7eb2e8f9f7 394
<> 144:ef7eb2e8f9f7 395 huart->gState = HAL_UART_STATE_BUSY;
<> 144:ef7eb2e8f9f7 396
<> 144:ef7eb2e8f9f7 397 /* Clear UESM bit */
<> 144:ef7eb2e8f9f7 398 CLEAR_BIT(huart->Instance->CR1, USART_CR1_UESM);
<> 144:ef7eb2e8f9f7 399
<> 144:ef7eb2e8f9f7 400 huart->gState = HAL_UART_STATE_READY;
<> 144:ef7eb2e8f9f7 401
<> 144:ef7eb2e8f9f7 402 /* Process Unlocked */
<> 144:ef7eb2e8f9f7 403 __HAL_UNLOCK(huart);
<> 144:ef7eb2e8f9f7 404
<> 144:ef7eb2e8f9f7 405 return HAL_OK;
<> 144:ef7eb2e8f9f7 406 }
<> 144:ef7eb2e8f9f7 407
<> 144:ef7eb2e8f9f7 408 /**
<> 144:ef7eb2e8f9f7 409 * @brief UART wakeup from Stop mode callback.
<> 144:ef7eb2e8f9f7 410 * @param huart: UART handle.
<> 144:ef7eb2e8f9f7 411 * @retval None
<> 144:ef7eb2e8f9f7 412 */
<> 144:ef7eb2e8f9f7 413 __weak void HAL_UARTEx_WakeupCallback(UART_HandleTypeDef *huart)
<> 144:ef7eb2e8f9f7 414 {
<> 144:ef7eb2e8f9f7 415 /* Prevent unused argument(s) compilation warning */
<> 144:ef7eb2e8f9f7 416 UNUSED(huart);
<> 144:ef7eb2e8f9f7 417
<> 144:ef7eb2e8f9f7 418 /* NOTE : This function should not be modified, when the callback is needed,
<> 144:ef7eb2e8f9f7 419 the HAL_UARTEx_WakeupCallback can be implemented in the user file.
<> 144:ef7eb2e8f9f7 420 */
<> 144:ef7eb2e8f9f7 421 }
<> 144:ef7eb2e8f9f7 422
<> 144:ef7eb2e8f9f7 423 /**
<> 144:ef7eb2e8f9f7 424 * @}
<> 144:ef7eb2e8f9f7 425 */
<> 144:ef7eb2e8f9f7 426
<> 144:ef7eb2e8f9f7 427 /**
<> 144:ef7eb2e8f9f7 428 * @}
<> 144:ef7eb2e8f9f7 429 */
<> 144:ef7eb2e8f9f7 430
<> 144:ef7eb2e8f9f7 431 /** @addtogroup UARTEx_Private_Functions
<> 144:ef7eb2e8f9f7 432 * @{
<> 144:ef7eb2e8f9f7 433 */
<> 144:ef7eb2e8f9f7 434
<> 144:ef7eb2e8f9f7 435 /**
<> 144:ef7eb2e8f9f7 436 * @brief Initialize the UART wake-up from stop mode parameters when triggered by address detection.
<> 144:ef7eb2e8f9f7 437 * @param huart: UART handle.
<> 144:ef7eb2e8f9f7 438 * @param WakeUpSelection: UART wake up from stop mode parameters.
<> 144:ef7eb2e8f9f7 439 * @retval None
<> 144:ef7eb2e8f9f7 440 */
<> 144:ef7eb2e8f9f7 441 static void UARTEx_Wakeup_AddressConfig(UART_HandleTypeDef *huart, UART_WakeUpTypeDef WakeUpSelection)
<> 144:ef7eb2e8f9f7 442 {
<> 144:ef7eb2e8f9f7 443 assert_param(IS_UART_ADDRESSLENGTH_DETECT(WakeUpSelection.AddressLength));
<> 144:ef7eb2e8f9f7 444
<> 144:ef7eb2e8f9f7 445 /* Set the USART address length */
<> 144:ef7eb2e8f9f7 446 MODIFY_REG(huart->Instance->CR2, USART_CR2_ADDM7, WakeUpSelection.AddressLength);
<> 144:ef7eb2e8f9f7 447
<> 144:ef7eb2e8f9f7 448 /* Set the USART address node */
<> 144:ef7eb2e8f9f7 449 MODIFY_REG(huart->Instance->CR2, USART_CR2_ADD, ((uint32_t)WakeUpSelection.Address << UART_CR2_ADDRESS_LSB_POS));
<> 144:ef7eb2e8f9f7 450 }
<> 144:ef7eb2e8f9f7 451
<> 144:ef7eb2e8f9f7 452 /**
<> 144:ef7eb2e8f9f7 453 * @}
<> 144:ef7eb2e8f9f7 454 */
<> 144:ef7eb2e8f9f7 455
<> 144:ef7eb2e8f9f7 456 #endif /* HAL_UART_MODULE_ENABLED */
<> 144:ef7eb2e8f9f7 457
<> 144:ef7eb2e8f9f7 458 /**
<> 144:ef7eb2e8f9f7 459 * @}
<> 144:ef7eb2e8f9f7 460 */
<> 144:ef7eb2e8f9f7 461
<> 144:ef7eb2e8f9f7 462 /**
<> 144:ef7eb2e8f9f7 463 * @}
<> 144:ef7eb2e8f9f7 464 */
<> 144:ef7eb2e8f9f7 465
<> 144:ef7eb2e8f9f7 466 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/