mbed-F401 - mbed library with additional peripherals for ST F…

Users » dreschpe » Code » mbed-F401

Peter Drescher / mbed-F401

mbed library with additional peripherals for ST F401 board

Fork of mbed-src by mbed official

This mbed LIB has additional peripherals for ST F401 board

UART2 : PA_3 rx, PA_2 tx
UART3 : PC_7 rx, PC_6 tx
I2C2 : PB_3 SDA, PB_10 SCL
I2C3 : PB_4 SDA, PA_8 SCL

targets/cmsis/TARGET_STM/TARGET_NUCLEO_F401RE/stm32f4xx_hal_uart.c@106:ced8cbb51063, 2014-02-26 (annotated)

Committer:: mbed_official
Date:: Wed Feb 26 09:45:12 2014 +0000
Revision:: 106:ced8cbb51063
Parent:: 87:085cde657901

Synchronized with git revision 4222735eff5868389433f0e9271976b39c8115cd



Full URL: https://github.com/mbedmicro/mbed/commit/4222735eff5868389433f0e9271976b39c8115cd/



[NUCLEO_xxx] Update STM32CubeF4 driver V1.0.0 + update license

Who changed what in which revision?

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

Repository toolbox

Export to desktop IDE

Repository details

Type:	Library
Created:	08 Mar 2014
Imports:	301
Forks:	0
Commits:	115
Dependents:	0
Dependencies:	0
Followers:	15
Issues:	1

targets/cmsis/TARGET_STM/TARGET_NUCLEO_F401RE/stm32f4xx_hal_uart.c@106:ced8cbb51063, 2014-02-26 (annotated)

Who changed what in which revision?

Repository toolbox

Repository details

Important Information for this Arm website

Access Warning