在STM32F103C8T6中使用HAL库函数的UART模块时注意事项

开发板：普中A7板子
核心板：STM32F103C8T6
HAL库版本：STM32Cube_FW_F1_V1.8.0

注意事项：
1、在HAL_UART_MspInit()函数中不能使用HAL_UART_Receive_IT()或HAL_UART_Transmit_IT()函数，否则不会进入中断处理函数中，也就是说设置中断无效;
2、在HAL_UART_RxCpltCallback()回调函数中不能使用HAL_UART_Transmit_IT()进行发送数据，否则发送出去的就是乱码’?'这个符号;
3、在HAL_UART_Transmit(&UART_Struct,recv_buf,50,1000)这个函数中参数50会导致输出一部分字符后卡死;只能设置为HAL_UART_Transmit(&UART_Struct,recv_buf,1,1000)参数为1;
4、如果在HAL_UART_RxCpltCallback()函数中使用HAL_UART_Transmit()来发送数据，串口调试助手发送数据到单片机点快一点的话 就会卡死，而使用直接写寄存器发就不会卡死;在printf重定位中的fputc()函数中使用HAL_UART_Transmit()来发送数据，并在main()主函数中的while(1)死循环里面只用printf()函数打印数据就不会出现卡死的情况；
5、不能在USART1_IRQHandler()中断处理函数中使用HAL_UART_Receive()和HAL_UART_Transmit()函数，因为这两个是阻塞式的容易造成程序卡死

/****************************************************************************************
 * 函数功能：main主函数
 * 参    数：
 * 返 回 值：
 * 注意事项：
 ***************************************************************************************/
int main(void)
{
	unsigned char i, j = 0;
	HAL_Init();
	SystemClock_Config();
	
	UART_Init();
	Led_Init();
	
	printf("This is test function\r\n");

	while (1)
	{
		printf("Hello World %d\r\n", j++);
//		for(i=0; i<8; i++)
//		{
//			LED_ON(i);
//			HAL_Delay(500);
//			LED_OFF(i);	
//		}		
	}
}

/**
  * @brief  System Clock Configuration
  *         The system Clock is configured as follow : 
  *            System Clock source            = PLL (HSI)
  *            SYSCLK(Hz)                     = 72000000
  *            HCLK(Hz)                       = 72000000
  *            AHB Prescaler                  = 1
  *            APB1 Prescaler                 = 2
  *            APB2 Prescaler                 = 1
  *            PLLMUL                         = 9
  *            Flash Latency(WS)              = 2
  * @param  None
  * @retval None
  */
void SystemClock_Config(void)
{
	RCC_ClkInitTypeDef clkinitstruct = {0};
	RCC_OscInitTypeDef oscinitstruct = {0};

	/* Configure PLL ------------------------------------------------------*/
	/* PLL configuration: PLLCLK = HSE * PLLMUL = 8 * 9 = 72 MHz */
	/* PREDIV1 configuration: PREDIV1CLK = PLLCLK / HSEPredivValue = 64 / 1 = 64 MHz */
	/* Enable HSI and activate PLL with HSi_DIV2 as source */
	oscinitstruct.OscillatorType  = RCC_OSCILLATORTYPE_HSE;
	oscinitstruct.HSEState        = RCC_HSE_ON;
	oscinitstruct.HSEPredivValue  = RCC_HSE_PREDIV_DIV1;
	oscinitstruct.PLL.PLLState    = RCC_PLL_ON;
	oscinitstruct.PLL.PLLSource   = RCC_PLLSOURCE_HSE;
	oscinitstruct.PLL.PLLMUL      = RCC_PLL_MUL9;
	if (HAL_RCC_OscConfig(&oscinitstruct)!= HAL_OK)
	{
	/* Initialization Error */
	while(1); 
	}

	/* Select PLL as system clock source and configure the HCLK, PCLK1 and PCLK2 
	 clocks dividers */
	clkinitstruct.ClockType = (RCC_CLOCKTYPE_SYSCLK | RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_PCLK1 | RCC_CLOCKTYPE_PCLK2);
	clkinitstruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
	clkinitstruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
	clkinitstruct.APB2CLKDivider = RCC_HCLK_DIV1;
	clkinitstruct.APB1CLKDivider = RCC_HCLK_DIV2;  
	if (HAL_RCC_ClockConfig(&clkinitstruct, FLASH_LATENCY_2)!= HAL_OK)
	{
	/* Initialization Error */
	while(1); 
	}
}

/****************************************************************************************
 * 函数功能：LED初始化函数，初始化之后关闭所以LED灯
 * 参    数：
 * 返 回 值：
 * 注意事项：
 ***************************************************************************************/
void Led_Init(void)
{
	GPIO_InitTypeDef GPIO_InitStruct;
	
	__HAL_RCC_GPIOA_CLK_ENABLE();
	
	GPIO_InitStruct.Pin = GPIO_PIN_0|GPIO_PIN_1|GPIO_PIN_2|GPIO_PIN_3
						  |GPIO_PIN_4|GPIO_PIN_5|GPIO_PIN_6|GPIO_PIN_7;
	GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
	GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
	
	HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
	
	LED_ALL_OFF();
	
	return;
}

UART_HandleTypeDef UART_Struct;
uint8_t recv_buf[1] = {0};		/* 接收缓冲区 */


/****************************************************************************************
 * 函数功能：UART初始化函数
 * 参    数：
 * 返 回 值：
 * 注意事项：HAL_UART_Receive_IT()要在HAL_UART_Init()之后调用
 ***************************************************************************************/
void UART_Init(void)
{
	UART_Struct.Instance = USART1;
	UART_Struct.Init.HwFlowCtl = UART_HWCONTROL_NONE;
	UART_Struct.Init.WordLength = UART_WORDLENGTH_8B;
	UART_Struct.Init.BaudRate = 115200;
	UART_Struct.Init.Mode = UART_MODE_TX_RX;
	UART_Struct.Init.Parity = UART_PARITY_NONE;
	UART_Struct.Init.StopBits = UART_STOPBITS_1;
	
	HAL_UART_Init(&UART_Struct);
	
//	__HAL_UART_ENABLE_IT(&UART_Struct, UART_IT_RXNE);	/* 跟野火的代码学的 */
	HAL_UART_Receive_IT(&UART_Struct, recv_buf, 1);
	
	return;
}

/****************************************************************************************
 * 函数功能：HAL_UART_Init中的调用函数
 * 参    数：
 * 返 回 值：
 * 注意事项：HAL_UART_Receive_IT()不能在HAL_UART_MspInit()中调用
 ***************************************************************************************/
void HAL_UART_MspInit(UART_HandleTypeDef *huart)
{
	GPIO_InitTypeDef GPIO_InitStuct;
	
	__HAL_RCC_GPIOA_CLK_ENABLE();
	__HAL_RCC_USART1_CLK_ENABLE();
//	__HAL_RCC_AFIO_CLK_ENABLE();	/* 怀疑不需要开，在正点原子代码中开启，野火代码中未开 */
	
	GPIO_InitStuct.Mode = GPIO_MODE_AF_PP;
	GPIO_InitStuct.Pin = GPIO_PIN_9;
	GPIO_InitStuct.Speed = GPIO_SPEED_FREQ_HIGH;
	HAL_GPIO_Init(GPIOA, &GPIO_InitStuct);

	GPIO_InitStuct.Mode = GPIO_MODE_AF_INPUT;
	GPIO_InitStuct.Pin = GPIO_PIN_10;
	GPIO_InitStuct.Pull = GPIO_NOPULL;
	
	HAL_GPIO_Init(GPIOA, &GPIO_InitStuct);
	
	HAL_NVIC_EnableIRQ(USART1_IRQn);
			
	return;
}

/****************************************************************************************
 * 函数功能：HAL_UART_IRQHandler中的回调函数
 * 参    数：
 * 返 回 值：
 * 注意事项：使用HAL_UART_Transmit()来发送数据，串口调试助手发送数据到单片机点快一点的话
 *			 就会卡死，而使用直接写寄存器发就不会卡死;
 ***************************************************************************************/
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)
{
	WRITE_REG(UART_Struct.Instance->DR, recv_buf[0]);
//	HAL_UART_Transmit(&UART_Struct,recv_buf,1,1000);
//	while(__HAL_UART_GET_FLAG(&UART_Struct, UART_FLAG_TC) != SET);
	HAL_UART_Receive_IT(&UART_Struct, recv_buf, 1);
	
	return;
}

/****************************************************************************************
 * 函数功能：为了移植printf函数
 * 参    数：
 * 返 回 值：
 * 注意事项：
 ***************************************************************************************/
int fputc(int ch, FILE * f)
{
	HAL_UART_Transmit(&UART_Struct, (uint8_t*)&ch, 1, 1000);
	
	return 0;
}

/****************************************************************************************
 * 函数功能：USART1_IRQHandler中断处理函数
 * 参    数：
 * 返 回 值：
 * 注意事项：不能使用HAL_UART_Receive()和HAL_UART_Transmit()函数，因为这两个是阻塞式的
 *			 容易造成程序卡死
 ***************************************************************************************/
void USART1_IRQHandler(void)
{
	HAL_UART_IRQHandler(&UART_Struct);
	
#if 0	
	uint16_t ch = 0;
//	uint8_t ch = 0;
	
	if(__HAL_UART_GET_FLAG(&UART_Struct, UART_FLAG_RXNE) != RESET)
	{
		/* 使用HAL库函数接收和发送字符容易程序卡死 */
//		HAL_UART_Receive(&UART_Struct, &ch, 1, 1000);		
//		HAL_UART_Transmit(&UART_Struct, &ch, 1, 1000);
		ch = (uint16_t)READ_REG(UART_Struct.Instance->DR);
		WRITE_REG(UART_Struct.Instance->DR, ch); 
	}
#endif	
}