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