Ricardo Benitez / mbed

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Fork of mbed by mbed official

TARGET_DISCO_F746NG/stm32f7xx_hal_usart_ex.h@107:4f6c30876dfa, 2015-09-16 (annotated)

Committer:
Kojto
Date:
Wed Sep 16 15:32:31 2015 +0100
Revision:
107:4f6c30876dfa
Child:
116:c0f6e94411f5
Release 107  of the mbed library



Changes:

- new platforms - DISCO_F746NG, DISCO_L476VG, NUCLEO_L476RG

- KL43Z - bugfix RTC init function

- K20 - SPI mode fix

Who changed what in which revision?

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