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

本文介绍了在使用STM32F103C8T6和HAL库进行UART通信时需要注意的问题。包括HAL_UART_MspInit()中禁止使用中断发送和接收函数,HAL_UART_RxCpltCallback()回调中避免发送乱码,HAL_UART_Transmit()参数限制,快速收发可能导致的卡死问题,以及中断处理函数中避免阻塞式收发等细节。

开发板:普中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 = {
   
   
<think>嗯,用户需要STM32F103C8T6HAL文档指南。这个问题很典型,开发者刚接触STM32Cube生态普遍会遇到。用户明确提到了"HAL用户手册"和"使用指南",说明ta需要的是官方结构化文档而非零散教程。 用户可能正在移植旧项目到HAL,或是从标准转向CubeMX开发。考虑到STM32F103C8T6属于经典入门级MCU,用户很可能是嵌入式新手,需要特别注意解释文档获取路径的每个操作细节。 核心难点在于:ST官方文档体系较分散。需要同提供三层次资源:工具链安装(CubeMX)、外设文档(HAL源码说明)、具体芯片支持包(C6T6的兼容性)。特别要强调HAL的通用性——所有Cortex-M3芯片的HAL驱动框架相同,避免用户误以为需要特定型号手册。 上次回复中推荐的UM1850手册其实已经过(2020年停更),但仍是理解HAL架构的最佳入口。必须补充说明替代方案:直接查阅源码注释和CubeMX生成的代码模板更有效。用户可能不知道.h文件里的doxygen注释就是最实文档。 需要预警常见坑点:HAL版本与CubeMX版本必须严格匹配,这点在ST社区有大量求助帖。应该在"注意事项"里用⚠️emoji突出显示,毕竟版本冲突会导致诡异硬件错误。 衍生问题设计要覆盖学习路径:从文档获取(Q1)到具体应用(Q3的UART示例),再到排错(Q4)和进阶开发(Q2的钟配置)。特别加入Q5的调试技巧,因为HAL错误回调机制是新手的痛点区。</think>以下是针对STM32F103C8T6使用HAL的完整指南: ### 一、官方核心资源 1. **HAL文档** 直接查阅STM32CubeF1软件包中的文档: 📁 `STM32Cube_FW_F1_Vx.x.x/Drivers/STM32F1xx_HAL_Driver/` 目录下的: - `STM32F1xx_HAL_Driver_User_Manual.chm`(Windows帮助文件) - `stm32f1xx_hal_ppp.c`源码文件顶部的API注释(关键实文档) 2. **芯片专用参考** - **数据手册**:[DS5319] STM32F103x8数据手册(引脚定义/电气特性) - **参考手册**:[RM0008] STM32F10xxx参考手册(寄存器级操作指南)[^1] --- ### 二、开发环境搭建 1. **必需工具**: ```bash STM32CubeMX # 图形化配置工具(生成初始化代码) Keil MDK/STM32CubeIDE # 开发环境(推荐免费CubeIDE) ST-Link Utility # 烧录工具 ``` 2. **操作流程**: ```mermaid graph TD A[CubeMX新建工程] --> B[选择STM32F103C8] B --> C[配置钟/外设] C --> D[生成HAL代码] D --> E[IDE中编写业务逻辑] ``` --- ### 三、HAL关键使用模式 1. **外设初始化模板**(以UART为例): ```c UART_HandleTypeDef huart1; void MX_USART1_UART_Init(void) { huart1.Instance = USART1; huart1.Init.BaudRate = 115200; huart1.Init.WordLength = UART_WORDLENGTH_8B; huart1.Init.StopBits = UART_STOPBITS_1; huart1.Init.Parity = UART_PARITY_NONE; HAL_UART_Init(&huart1); // 自动配置钟和GPIO } ``` 2. **中断处理规范**: ```c void USART1_IRQHandler(void) { HAL_UART_IRQHandler(&huart1); // HAL统一中断入口 } // 回调函数实现 void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { // 收到数据触发 } ``` --- ### 四、调试技巧 1. **错误排查**: - 检查`HAL_StatusTypeDef`返回值(如`HAL_OK`/`HAL_ERROR`) - 使用`__HAL_RCC_GPIOA_CLK_ENABLE()`确保外设钟已开启 - 在`stm32f1xx_hal_conf.h`中启用`#define USE_FULL_ASSERT` 2. **低功耗优化**: ```c HAL_SuspendTick(); // 进入低功耗前暂停SysTick HAL_PWR_EnterSLEEPMode(PWR_MAINREGULATOR_ON, PWR_SLEEPENTRY_WFI); ``` --- ### 五、实用资源 1. **官方示例代码**: 📁 `STM32Cube_FW_F1/Projects/STM32F103RB-Nucleo/Examples/` 2. **社区支持**: - [STM32中文社区](https://shequ.stmicroelectronics.cn) - GitHub搜索`STM32F103C8T6 HAL`(>200个开源项目) > ⚠️ **注意事项**:HAL版本需与CubeMX严格匹配,建议使用最新稳定版(当前推荐STM32Cube_FW_F1 V1.8.5) ---
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值