SPKT
targets/cmsis/TARGET_STM/TARGET_STM32F7/stm32f7xx_hal_usart_ex.h@0:e87aa4c49e95, 2019-06-04 (annotated)
- Committer:
- phungductung
- Date:
- Tue Jun 04 21:51:46 2019 +0000
- Revision:
- 0:e87aa4c49e95
libray
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
phungductung | 0:e87aa4c49e95 | 1 | /** |
phungductung | 0:e87aa4c49e95 | 2 | ****************************************************************************** |
phungductung | 0:e87aa4c49e95 | 3 | * @file stm32f7xx_hal_usart_ex.h |
phungductung | 0:e87aa4c49e95 | 4 | * @author MCD Application Team |
phungductung | 0:e87aa4c49e95 | 5 | * @version V1.0.4 |
phungductung | 0:e87aa4c49e95 | 6 | * @date 09-December-2015 |
phungductung | 0:e87aa4c49e95 | 7 | * @brief Header file of USART HAL Extension module. |
phungductung | 0:e87aa4c49e95 | 8 | ****************************************************************************** |
phungductung | 0:e87aa4c49e95 | 9 | * @attention |
phungductung | 0:e87aa4c49e95 | 10 | * |
phungductung | 0:e87aa4c49e95 | 11 | * <h2><center>© COPYRIGHT(c) 2015 STMicroelectronics</center></h2> |
phungductung | 0:e87aa4c49e95 | 12 | * |
phungductung | 0:e87aa4c49e95 | 13 | * Redistribution and use in source and binary forms, with or without modification, |
phungductung | 0:e87aa4c49e95 | 14 | * are permitted provided that the following conditions are met: |
phungductung | 0:e87aa4c49e95 | 15 | * 1. Redistributions of source code must retain the above copyright notice, |
phungductung | 0:e87aa4c49e95 | 16 | * this list of conditions and the following disclaimer. |
phungductung | 0:e87aa4c49e95 | 17 | * 2. Redistributions in binary form must reproduce the above copyright notice, |
phungductung | 0:e87aa4c49e95 | 18 | * this list of conditions and the following disclaimer in the documentation |
phungductung | 0:e87aa4c49e95 | 19 | * and/or other materials provided with the distribution. |
phungductung | 0:e87aa4c49e95 | 20 | * 3. Neither the name of STMicroelectronics nor the names of its contributors |
phungductung | 0:e87aa4c49e95 | 21 | * may be used to endorse or promote products derived from this software |
phungductung | 0:e87aa4c49e95 | 22 | * without specific prior written permission. |
phungductung | 0:e87aa4c49e95 | 23 | * |
phungductung | 0:e87aa4c49e95 | 24 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" |
phungductung | 0:e87aa4c49e95 | 25 | * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
phungductung | 0:e87aa4c49e95 | 26 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE |
phungductung | 0:e87aa4c49e95 | 27 | * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE |
phungductung | 0:e87aa4c49e95 | 28 | * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL |
phungductung | 0:e87aa4c49e95 | 29 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR |
phungductung | 0:e87aa4c49e95 | 30 | * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER |
phungductung | 0:e87aa4c49e95 | 31 | * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, |
phungductung | 0:e87aa4c49e95 | 32 | * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
phungductung | 0:e87aa4c49e95 | 33 | * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
phungductung | 0:e87aa4c49e95 | 34 | * |
phungductung | 0:e87aa4c49e95 | 35 | ****************************************************************************** |
phungductung | 0:e87aa4c49e95 | 36 | */ |
phungductung | 0:e87aa4c49e95 | 37 | |
phungductung | 0:e87aa4c49e95 | 38 | /* Define to prevent recursive inclusion -------------------------------------*/ |
phungductung | 0:e87aa4c49e95 | 39 | #ifndef __STM32F7xx_HAL_USART_EX_H |
phungductung | 0:e87aa4c49e95 | 40 | #define __STM32F7xx_HAL_USART_EX_H |
phungductung | 0:e87aa4c49e95 | 41 | |
phungductung | 0:e87aa4c49e95 | 42 | #ifdef __cplusplus |
phungductung | 0:e87aa4c49e95 | 43 | extern "C" { |
phungductung | 0:e87aa4c49e95 | 44 | #endif |
phungductung | 0:e87aa4c49e95 | 45 | |
phungductung | 0:e87aa4c49e95 | 46 | /* Includes ------------------------------------------------------------------*/ |
phungductung | 0:e87aa4c49e95 | 47 | #include "stm32f7xx_hal_def.h" |
phungductung | 0:e87aa4c49e95 | 48 | |
phungductung | 0:e87aa4c49e95 | 49 | /** @addtogroup STM32F7xx_HAL_Driver |
phungductung | 0:e87aa4c49e95 | 50 | * @{ |
phungductung | 0:e87aa4c49e95 | 51 | */ |
phungductung | 0:e87aa4c49e95 | 52 | |
phungductung | 0:e87aa4c49e95 | 53 | /** @addtogroup USARTEx |
phungductung | 0:e87aa4c49e95 | 54 | * @{ |
phungductung | 0:e87aa4c49e95 | 55 | */ |
phungductung | 0:e87aa4c49e95 | 56 | |
phungductung | 0:e87aa4c49e95 | 57 | /* Exported types ------------------------------------------------------------*/ |
phungductung | 0:e87aa4c49e95 | 58 | /* Exported constants --------------------------------------------------------*/ |
phungductung | 0:e87aa4c49e95 | 59 | /** @defgroup USARTEx_Exported_Constants USARTEx Exported Constants |
phungductung | 0:e87aa4c49e95 | 60 | * @{ |
phungductung | 0:e87aa4c49e95 | 61 | */ |
phungductung | 0:e87aa4c49e95 | 62 | |
phungductung | 0:e87aa4c49e95 | 63 | /** @defgroup USARTEx_Word_Length USARTEx Word Length |
phungductung | 0:e87aa4c49e95 | 64 | * @{ |
phungductung | 0:e87aa4c49e95 | 65 | */ |
phungductung | 0:e87aa4c49e95 | 66 | #define USART_WORDLENGTH_7B ((uint32_t)USART_CR1_M_1) |
phungductung | 0:e87aa4c49e95 | 67 | #define USART_WORDLENGTH_8B ((uint32_t)0x00000000) |
phungductung | 0:e87aa4c49e95 | 68 | #define USART_WORDLENGTH_9B ((uint32_t)USART_CR1_M_0) |
phungductung | 0:e87aa4c49e95 | 69 | /** |
phungductung | 0:e87aa4c49e95 | 70 | * @} |
phungductung | 0:e87aa4c49e95 | 71 | */ |
phungductung | 0:e87aa4c49e95 | 72 | |
phungductung | 0:e87aa4c49e95 | 73 | /** |
phungductung | 0:e87aa4c49e95 | 74 | * @} |
phungductung | 0:e87aa4c49e95 | 75 | */ |
phungductung | 0:e87aa4c49e95 | 76 | |
phungductung | 0:e87aa4c49e95 | 77 | /* Exported functions --------------------------------------------------------*/ |
phungductung | 0:e87aa4c49e95 | 78 | |
phungductung | 0:e87aa4c49e95 | 79 | /* Private macros ------------------------------------------------------------*/ |
phungductung | 0:e87aa4c49e95 | 80 | /** @defgroup USARTEx_Private_Macros USARTEx Private Macros |
phungductung | 0:e87aa4c49e95 | 81 | * @{ |
phungductung | 0:e87aa4c49e95 | 82 | */ |
phungductung | 0:e87aa4c49e95 | 83 | |
phungductung | 0:e87aa4c49e95 | 84 | /** @brief Computes the USART mask to apply to retrieve the received data |
phungductung | 0:e87aa4c49e95 | 85 | * according to the word length and to the parity bits activation. |
phungductung | 0:e87aa4c49e95 | 86 | * If PCE = 1, the parity bit is not included in the data extracted |
phungductung | 0:e87aa4c49e95 | 87 | * by the reception API(). |
phungductung | 0:e87aa4c49e95 | 88 | * This masking operation is not carried out in the case of |
phungductung | 0:e87aa4c49e95 | 89 | * DMA transfers. |
phungductung | 0:e87aa4c49e95 | 90 | * @param __HANDLE__: specifies the USART Handle |
phungductung | 0:e87aa4c49e95 | 91 | * @retval none |
phungductung | 0:e87aa4c49e95 | 92 | */ |
phungductung | 0:e87aa4c49e95 | 93 | #define __HAL_USART_MASK_COMPUTATION(__HANDLE__) \ |
phungductung | 0:e87aa4c49e95 | 94 | do { \ |
phungductung | 0:e87aa4c49e95 | 95 | if ((__HANDLE__)->Init.WordLength == USART_WORDLENGTH_9B) \ |
phungductung | 0:e87aa4c49e95 | 96 | { \ |
phungductung | 0:e87aa4c49e95 | 97 | if ((__HANDLE__)->Init.Parity == USART_PARITY_NONE) \ |
phungductung | 0:e87aa4c49e95 | 98 | { \ |
phungductung | 0:e87aa4c49e95 | 99 | (__HANDLE__)->Mask = 0x01FF ; \ |
phungductung | 0:e87aa4c49e95 | 100 | } \ |
phungductung | 0:e87aa4c49e95 | 101 | else \ |
phungductung | 0:e87aa4c49e95 | 102 | { \ |
phungductung | 0:e87aa4c49e95 | 103 | (__HANDLE__)->Mask = 0x00FF ; \ |
phungductung | 0:e87aa4c49e95 | 104 | } \ |
phungductung | 0:e87aa4c49e95 | 105 | } \ |
phungductung | 0:e87aa4c49e95 | 106 | else if ((__HANDLE__)->Init.WordLength == USART_WORDLENGTH_8B) \ |
phungductung | 0:e87aa4c49e95 | 107 | { \ |
phungductung | 0:e87aa4c49e95 | 108 | if ((__HANDLE__)->Init.Parity == USART_PARITY_NONE) \ |
phungductung | 0:e87aa4c49e95 | 109 | { \ |
phungductung | 0:e87aa4c49e95 | 110 | (__HANDLE__)->Mask = 0x00FF ; \ |
phungductung | 0:e87aa4c49e95 | 111 | } \ |
phungductung | 0:e87aa4c49e95 | 112 | else \ |
phungductung | 0:e87aa4c49e95 | 113 | { \ |
phungductung | 0:e87aa4c49e95 | 114 | (__HANDLE__)->Mask = 0x007F ; \ |
phungductung | 0:e87aa4c49e95 | 115 | } \ |
phungductung | 0:e87aa4c49e95 | 116 | } \ |
phungductung | 0:e87aa4c49e95 | 117 | else if ((__HANDLE__)->Init.WordLength == USART_WORDLENGTH_7B) \ |
phungductung | 0:e87aa4c49e95 | 118 | { \ |
phungductung | 0:e87aa4c49e95 | 119 | if ((__HANDLE__)->Init.Parity == USART_PARITY_NONE) \ |
phungductung | 0:e87aa4c49e95 | 120 | { \ |
phungductung | 0:e87aa4c49e95 | 121 | (__HANDLE__)->Mask = 0x007F ; \ |
phungductung | 0:e87aa4c49e95 | 122 | } \ |
phungductung | 0:e87aa4c49e95 | 123 | else \ |
phungductung | 0:e87aa4c49e95 | 124 | { \ |
phungductung | 0:e87aa4c49e95 | 125 | (__HANDLE__)->Mask = 0x003F ; \ |
phungductung | 0:e87aa4c49e95 | 126 | } \ |
phungductung | 0:e87aa4c49e95 | 127 | } \ |
phungductung | 0:e87aa4c49e95 | 128 | } while(0) |
phungductung | 0:e87aa4c49e95 | 129 | |
phungductung | 0:e87aa4c49e95 | 130 | #define IS_USART_WORD_LENGTH(__LENGTH__) (((__LENGTH__) == USART_WORDLENGTH_7B) || \ |
phungductung | 0:e87aa4c49e95 | 131 | ((__LENGTH__) == USART_WORDLENGTH_8B) || \ |
phungductung | 0:e87aa4c49e95 | 132 | ((__LENGTH__) == USART_WORDLENGTH_9B)) |
phungductung | 0:e87aa4c49e95 | 133 | /** |
phungductung | 0:e87aa4c49e95 | 134 | * @} |
phungductung | 0:e87aa4c49e95 | 135 | */ |
phungductung | 0:e87aa4c49e95 | 136 | |
phungductung | 0:e87aa4c49e95 | 137 | /* Exported functions --------------------------------------------------------*/ |
phungductung | 0:e87aa4c49e95 | 138 | /* Initialization/de-initialization methods **********************************/ |
phungductung | 0:e87aa4c49e95 | 139 | /* IO operation methods *******************************************************/ |
phungductung | 0:e87aa4c49e95 | 140 | /* Peripheral Control methods ************************************************/ |
phungductung | 0:e87aa4c49e95 | 141 | /* Peripheral State methods **************************************************/ |
phungductung | 0:e87aa4c49e95 | 142 | |
phungductung | 0:e87aa4c49e95 | 143 | |
phungductung | 0:e87aa4c49e95 | 144 | /** |
phungductung | 0:e87aa4c49e95 | 145 | * @} |
phungductung | 0:e87aa4c49e95 | 146 | */ |
phungductung | 0:e87aa4c49e95 | 147 | |
phungductung | 0:e87aa4c49e95 | 148 | /** |
phungductung | 0:e87aa4c49e95 | 149 | * @} |
phungductung | 0:e87aa4c49e95 | 150 | */ |
phungductung | 0:e87aa4c49e95 | 151 | |
phungductung | 0:e87aa4c49e95 | 152 | #ifdef __cplusplus |
phungductung | 0:e87aa4c49e95 | 153 | } |
phungductung | 0:e87aa4c49e95 | 154 | #endif |
phungductung | 0:e87aa4c49e95 | 155 | |
phungductung | 0:e87aa4c49e95 | 156 | #endif /* __STM32F7xx_HAL_USART_EX_H */ |
phungductung | 0:e87aa4c49e95 | 157 | |
phungductung | 0:e87aa4c49e95 | 158 | /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ |