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