en 129 / mbed-dev

fix LPC812 PWM

Dependents:   IR_LED_Send

Fork of mbed-dev by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32L0/stm32l0xx_hal_uart_ex.c@113:b3775bf36a83, 2016-04-19 (annotated)

Committer:
mbed_official
Date:
Tue Apr 19 11:15:15 2016 +0100
Revision:
113:b3775bf36a83
Parent:
0:9b334a45a8ff 
Synchronized with git revision 896981126b34b6d9441e3eea77881c67a1ae3dbd



Full URL: https://github.com/mbedmicro/mbed/commit/896981126b34b6d9441e3eea77881c67a1ae3dbd/



Exporter tool addition for e2 studio

Who changed what in which revision?

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