en 129 / mbed-dev

fix LPC812 PWM

Dependents:   IR_LED_Send

Fork of mbed-dev by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32L4/stm32l4xx_hal_uart_ex.c@129:2e517c56bcfb, 2016-05-16 (annotated)

Committer:
nameless129
Date:
Mon May 16 16:50:30 2016 +0000
Revision:
129:2e517c56bcfb
Parent:
0:9b334a45a8ff 
PWM Fix:Duty 0%??H???????????????

Who changed what in which revision?

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