STM32单片机 HAL库printf函数重定向问题

已于 2022-07-14 10:48:56 修改
阅读量3.7k 收藏 31
点赞数 11
分类专栏： STM 文章标签： 单片机 stm32 c语言
于 2022-05-04 00:24:29 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/sygydxfwd/article/details/124564301
版权

使用场景：

STM32单片机 HAL库printf函数重定向问题，无法在串口助手中收到数据的bug记录
编程IDE为：STM32CubeIDE
单片机型号为：STM32F103C8T6

问题描述

在使用stm32 HAL库的USART进行串口发送的过程中，发现重定向后的printf函数无法在串口中收到数据，而且编译没有报错

/* USER CODE BEGIN Header */
/**
  ******************************************************************************
  * @file           : main.c
  * @brief          : Main program body
  ******************************************************************************
  * @attention
  *
  * Copyright (c) 2022 STMicroelectronics.
  * All rights reserved.
  *
  * This software is licensed under terms that can be found in the LICENSE file
  * in the root directory of this software component.
  * If no LICENSE file comes with this software, it is provided AS-IS.
  *
  ******************************************************************************
  */
/* USER CODE END Header */
/* Includes ------------------------------------------------------------------*/
#include "main.h"
#include "stdio.h"
/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */

/* USER CODE END Includes */

/* Private typedef -----------------------------------------------------------*/
/* USER CODE BEGIN PTD */

/* USER CODE END PTD */

/* Private define ------------------------------------------------------------*/
/* USER CODE BEGIN PD */
/* USER CODE END PD */

/* Private macro -------------------------------------------------------------*/
/* USER CODE BEGIN PM */

/* USER CODE END PM */

/* Private variables ---------------------------------------------------------*/
 I2C_HandleTypeDef hi2c1;

UART_HandleTypeDef huart1;

/* USER CODE BEGIN PV */

/* USER CODE END PV */

/* Private function prototypes -----------------------------------------------*/
void SystemClock_Config(void);
static void MX_GPIO_Init(void);
static void MX_I2C1_Init(void);
static void MX_USART1_UART_Init(void);
/* USER CODE BEGIN PFP */

/* USER CODE END PFP */

/* Private user code ---------------------------------------------------------*/
/* USER CODE BEGIN 0 */
#ifdef __GNUC__
  #define PUTCHAR_PROTOTYPE int __io_putchar(int ch)
#else
  #define PUTCHAR_PROTOTYPE int fputc(int ch, FILE *f)
#endif

PUTCHAR_PROTOTYPE
{
  HAL_UART_Transmit(&huart1,(uint8_t *)&ch,1,0xFFFF);//阻塞方式打印
  return ch;
}

/* USER CODE END 0 */

/**
  * @brief  The application entry point.
  * @retval int
  */
int main(void)
{
  /* USER CODE BEGIN 1 */

  /* USER CODE END 1 */

  /* MCU Configuration--------------------------------------------------------*/

  /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
  HAL_Init();

  /* USER CODE BEGIN Init */

  /* USER CODE END Init */

  /* Configure the system clock */
  SystemClock_Config();

  /* USER CODE BEGIN SysInit */

  /* USER CODE END SysInit */

  /* Initialize all configured peripherals */
  MX_GPIO_Init();
  MX_I2C1_Init();
  MX_USART1_UART_Init();
  /* USER CODE BEGIN 2 */

  /* USER CODE END 2 */

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
	//int a  = 20;
    /* USER CODE END WHILE */
	printf("Hello world!\r\n"); //调用串口输出函数测试内容;
	//HAL_UART_Transmit (&huart1,"使用HAL库函数发送数据\n\r",40,1000);
	HAL_Delay(500);
    /* USER CODE BEGIN 3 */
  }
  /* USER CODE END 3 */
}

/**
  * @brief System Clock Configuration
  * @retval None
  */
void SystemClock_Config(void)
{
  RCC_OscInitTypeDef RCC_OscInitStruct = {0};
  RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};

  /** Initializes the RCC Oscillators according to the specified parameters
  * in the RCC_OscInitTypeDef structure.
  */
  RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSI;
  RCC_OscInitStruct.HSIState = RCC_HSI_ON;
  RCC_OscInitStruct.HSICalibrationValue = RCC_HSICALIBRATION_DEFAULT;
  RCC_OscInitStruct.PLL.PLLState = RCC_PLL_NONE;
  if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
  {
    Error_Handler();
  }

  /** Initializes the CPU, AHB and APB buses clocks
  */
  RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
                              |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
  RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_HSI;
  RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
  RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV1;
  RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;

  if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_0) != HAL_OK)
  {
    Error_Handler();
  }
}

/**
  * @brief I2C1 Initialization Function
  * @param None
  * @retval None
  */
static void MX_I2C1_Init(void)
{

  /* USER CODE BEGIN I2C1_Init 0 */

  /* USER CODE END I2C1_Init 0 */

  /* USER CODE BEGIN I2C1_Init 1 */

  /* USER CODE END I2C1_Init 1 */
  hi2c1.Instance = I2C1;
  hi2c1.Init.ClockSpeed = 20000;
  hi2c1.Init.DutyCycle = I2C_DUTYCYCLE_2;
  hi2c1.Init.OwnAddress1 = 0;
  hi2c1.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT;
  hi2c1.Init.DualAddressMode = I2C_DUALADDRESS_DISABLE;
  hi2c1.Init.OwnAddress2 = 0;
  hi2c1.Init.GeneralCallMode = I2C_GENERALCALL_DISABLE;
  hi2c1.Init.NoStretchMode = I2C_NOSTRETCH_DISABLE;
  if (HAL_I2C_Init(&hi2c1) != HAL_OK)
  {
    Error_Handler();
  }
  /* USER CODE BEGIN I2C1_Init 2 */

  /* USER CODE END I2C1_Init 2 */

}

/**
  * @brief USART1 Initialization Function
  * @param None
  * @retval None
  */
static void MX_USART1_UART_Init(void)
{

  /* USER CODE BEGIN USART1_Init 0 */

  /* USER CODE END USART1_Init 0 */

  /* USER CODE BEGIN USART1_Init 1 */

  /* USER CODE END USART1_Init 1 */
  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;
  huart1.Init.Mode = UART_MODE_TX_RX;
  huart1.Init.HwFlowCtl = UART_HWCONTROL_NONE;
  huart1.Init.OverSampling = UART_OVERSAMPLING_16;
  if (HAL_UART_Init(&huart1) != HAL_OK)
  {
    Error_Handler();
  }
  /* USER CODE BEGIN USART1_Init 2 */

  /* USER CODE END USART1_Init 2 */

}

/**
  * @brief GPIO Initialization Function
  * @param None
  * @retval None
  */
static void MX_GPIO_Init(void)
{

  /* GPIO Ports Clock Enable */
  __HAL_RCC_GPIOA_CLK_ENABLE();
  __HAL_RCC_GPIOB_CLK_ENABLE();

}

/* USER CODE BEGIN 4 */

/* USER CODE END 4 */

/**
  * @brief  This function is executed in case of error occurrence.
  * @retval None
  */
void Error_Handler(void)
{
  /* USER CODE BEGIN Error_Handler_Debug */
  /* User can add his own implementation to report the HAL error return state */
  __disable_irq();
  while (1)
  {
  }
  /* USER CODE END Error_Handler_Debug */
}

#ifdef  USE_FULL_ASSERT
/**
  * @brief  Reports the name of the source file and the source line number
  *         where the assert_param error has occurred.
  * @param  file: pointer to the source file name
  * @param  line: assert_param error line source number
  * @retval None
  */
void assert_failed(uint8_t *file, uint32_t line)
{
  /* USER CODE BEGIN 6 */
  /* User can add his own implementation to report the file name and line number,
     ex: printf("Wrong parameters value: file %s on line %d\r\n", file, line) */
  /* USER CODE END 6 */
}
#endif /* USE_FULL_ASSERT */

原因分析：

重定向后的printf函数，如果没有在格式控制里面加“\r\n”就无法正确发送

例如：printf(“Hello World ! \r\n”);此条语句可以正常显示在串口助手中
printf(“Hello World !”);此条语句无法正确显示在串口助手中，而且单片机的串口TXD针脚没有发送任何数据

深入分析：

后续在阅读“The C Program Language”一书时，注意到在MS-DOS（微软的东东）环境中，文本文件是以\r\n来表示新的一行，而在UNIX/Linux中用\r表示换行，早期MacOS X的环境中用\n（现在可能已经与UNIX采用了相同的策略），意味着C在处理文本内容时，只有读到以上符号才会认为读到了“结束”符号，可以进行下一步显示操作，否则就认为没有结束，是一个不完整的数据（printf函数使用缓冲机制，会将读到的正确数据块保存到缓冲区后再进行显示）我自己理解C对于这个不完整的数据，只在缓冲区保存了一部分，没有结尾标识，故它不会把这一块数据从缓冲区送出去，因为这不是一个有效的数据，所以在USART管脚中不会发送任何数据。
上面提到了MS-DOS环境，但实际上我们使用的ARM的芯片，C的编译器和C标准都是可以设置的，具体支持用户设置到何种程度，要看IDE提供的配置项，还有一种解决办法是不使用缓冲机制，即让printf函数收到一个字符就转发一个字符，只作为一个转发作用，具体怎么实现以后再做补充

解决方案：

首先需要在main.c文件中添加以下代码

#ifdef __GNUC__
  #define PUTCHAR_PROTOTYPE int __io_putchar(int ch)
#else
  #define PUTCHAR_PROTOTYPE int fputc(int ch, FILE *f)
#endif

PUTCHAR_PROTOTYPE
{
  HAL_UART_Transmit(&huart1,(uint8_t *)&ch,1,0xFFFF);//阻塞方式打印
  return ch;
}

注意：一定要在头文件中添加

#include "stdio.h"

否则不能使用printf函数
使用如下测试语句可以正常工作

printf("Hello world!\r\n"); //调用串口输出函数测试内容;
printf("%d\r\n",30); //调用串口输出函数测试内容;

在这里插入图片描述

sygydxfwd
关注
  • 11
    点赞
  • 踩
  • 31
    收藏
    觉得还不错? 一键收藏
  • 3
    评论
专栏目录
STM32故障记录——printf重定向
w237838的博客
10-30 347
项目场景：在使用STM32的串口打印数据时，对printf进行重定向，遇到的一些报错和不能正常使用的问题，在这里做下记录！此警告通常是因为没有包含头文件“stdio.h”,因为printf也是一个库函数，它的声明在stdio.h文件中。一般是因为没有在“魔法棒”中勾选“Use MicroLIB”.
STM32-HAL库-printf函数重定向（简单易懂亲测有效）
weixin_55686654的博客
09-07 4597
由于STM32cubemx生成的HAL库代码没有printf，为了让这个函数能实现打印功能，我们必须要把这个函数重定向，让它重定向到串口中，把要输出的内容打印到串口中。
STM32F103之串口使用Printf
最新发布
qq_62689231的博客
06-10 177
选择异步模式（asynchronous），9600波特率、8位数据、1位停止位、无奇偶校验。重写重定向函数fput，在哪里写无所谓，建议在cudemax生成的usart文件里写。使用printf之前一定要勾选keil配置里的是否使用microLIB。三、主函数中加入代码测试。
stm32笔记（串口重写printf不能发送数据）
m0_74239763的博客
07-06 699
请注意，勾选 "Use MicroLIB" 选项后，编译器将使用MicroLIB库的函数和优化特性，因此你需要确保你的代码与MicroLIB库兼容，并且没有依赖于其他特定的C标准库函数或特性。在Keil中勾选 "Use MicroLIB" 选项会启用MicroLIB库，它是Keil提供的一种优化的C标准库替代方案。在一些特定的情况下，使用默认的C标准库可能更为合适。3. 适用于嵌入式系统：MicroLIB库专门为嵌入式系统设计，提供了一些针对嵌入式系统的特性和优化，如支持裁剪、对齐和紧凑的数据结构等。
STM32-HAL-串口的printf重定向
Gear Long 的博客
04-20 6603
使用两种方法实现在Keil中的串口重定向功能，使得STM32完成printf进行数据的打印。
STM32-HAL库-printf函数重定向（USART应用实例）
热门推荐
Calvin Haynes的Blog
02-01 1万+
STM32-HAL库-printf函数重定向（USART应用实例） 文章目录STM32-HAL库-printf函数重定向（USART应用实例）前言一、STM32CubeMX配置串口二、代码修改1.引入printf重定向代码块2.添加#include 前言 为了便于调试，我们可以利用printf打印出调试的信息，在STM32应用中，我们就可以利用printf函数通过串口打印信息到串口调试助手上 一、STM32CubeMX配置串口 配置好时钟树后配置串口： 二、代码修改 1.引入printf重定向代码块
STM32+HAL库调试printf串口打印
Embedded小趴菜的博客
11-18 4042
只需要重新定义fputc函数，在fputc的函数中将数据通过串口发送，称之为：fputc重定向或者printf重定向。同理，只需要重新定义fputc函数，在scanf的函数中将数据通过串口接收，称之为：scanf重定向
HM STM32F407 HAL库 printf 重定向到串口1
03-15
本教程将详细讲解如何在STM32F407上使用HAL库将`printf`函数的输出重定向到串口1，以便通过UART（通用异步收发传输器）进行调试或通信。 首先，我们需要了解`printf`函数。`printf`是C语言中的一个标准输出函数，...
stm32 hal库 多串口printf函数库
07-26
"stm32 hal库 多串口printf函数库"解决了这个问题，它提供了一个统一的接口，允许开发者使用标准的`printf`函数，而无需关心数据实际通过哪个串口发送。`printf`函数源自C语言，它支持丰富的数据类型转换，如%d...
STM32 HAL 库延时函数 HAL_Delay 解析
01-06
HAL 库有提供延时函数，只不过它只能实现简单的毫秒级别延时，没有实现 us 级别延时。 下面我们列出HAL 库实现延时相关的函数。首先是功能配置函数： //调用 HAL_SYSTICK_Config 函数配置每隔 1ms 中断一次 __weak ...
STM32L151HAL库例程.rar
03-17
STM32L151系列单片机是意法半导体（STMicroelectronics）推出的一款基于ARM Cortex-M3内核的超低功耗微控制器。HAL（Hardware Abstraction Layer，硬件抽象层）库是STM32官方提供的一个软件框架，旨在为开发者提供一...
STM32F4HAL库（最新版1.27.0）
06-04
STM32F4HAL库（最新版1.27.0） HAL库ST是官方推出来的外设库，内含使用说明书，欢迎下载。 STM32Cube MCU包，用于STM32F4系列（HAL、底层API和CMSIS（CORE、DSP和RTOS）、USB、TCP/IP、File system、RTOS和Graphic -...
stm32f103c8t6 串口重定向 debug有问题 printf不正常
m0_57145940的博客
10-24 620
c8t6 printf重定向 debug
HAL 库使用printf函数
qq_41174547的博客
05-10 2632
#include "main.h" #include "adc.h" #include "usart.h" #include "gpio.h" /* Private includes ----------------------------------------------------------*/ /* USER CODE BEGIN Includes */ #include "stdio.h" #ifdef __GNUC__ #define PUTCHAR_PROTOTYPE int __io.
STM32-HAL库关于printf函数重定向的问题
Welcome To 楠‘Blog
08-28 1131
最近在学习HAL库的时候，遇到了加入printf函数的重定向导致代码无法正常运行的情况。 通过自己的调试与查阅资料最终将这个问题解决。 这里主要是涉及到了一个半主机模式的问题。接下来我就详细的讲讲这个问题的解决方案（也就是使用微库法，或者使用代码法）。
HAL库中对printf进行重定向
ZLongTeng的博客
07-28 96
/阻塞方式打印,串口1。#include “stdio.h”//对printf进行重定向。
STM32 HAL库printf重定向的方法
xuxu_123_的博客
05-08 958
本文主要介绍，如何在使用外设HAL库中将串口输出重定向到printf。按照以上步骤可以将printf重定向到串口。2.2 修改编译报错。
关于STM32F4系列中printf重定向问题详解
qq_56807415的博客
06-26 3645
关于stm32F4系列的printf函数重定向以及相关寄存器详解
stm32 hal库使用printf函数
06-28
### 回答1： 在使用STM32 HAL库时，可以通过重定向标准输出流的方式使用printf函数。具体步骤如下： 1. 在main函数中调用HAL库提供的函数HAL_InitTick()，以初始化系统时钟。 2. 在main函数中调用HAL库提供的函数HAL_UART_Init()，以初始化UART串口通信。 3. 在main函数中调用HAL库提供的函数HAL_UART_MspInit()，以配置UART串口通信的GPIO引脚。 4. 在main函数中调用HAL库提供的函数fopen()，以打开标准输出流。 5. 在main函数中调用HAL库提供的函数freopen()，以重定向标准输出流到UART串口通信。 6. 在需要输出信息的地方，使用printf函数进行输出。 需要注意的是，使用printf函数会增加程序的代码大小和运行时间，因此在实际应用中需要根据具体情况进行考虑。 ### 回答2： STM32是一种嵌入式系统微控制器，STMicroelectronics公司推出的STM32 HAL库提供了许多方便函数来方便地管理芯片硬件资源。然而，STM32 HAL库不支持标准的stdio.h中的printf函数，这对于开发者来说是一个非常恼人的问题。本文将解释如何在STM32 HAL库中使用printf函数，并提供一些实际的代码示例。 使用printf函数 使用printf函数必须设置好串口或者USB虚拟串口。虚拟串口需要使用满足CDC或者VCP规范的USB转串口芯片硬件。这里介绍使用串口的方法。 步骤1：初始化USART2串口设备 void MX_USART2_UART_Init(void) { huart2.Instance = USART2; huart2.Init.BaudRate = 115200; huart2.Init.WordLength = UART_WORDLENGTH_8B; huart2.Init.StopBits = UART_STOPBITS_1; huart2.Init.Parity = UART_PARITY_NONE; huart2.Init.Mode = UART_MODE_TX_RX; huart2.Init.HwFlowCtl = UART_HWCONTROL_NONE; huart2.Init.OverSampling = UART_OVERSAMPLING_16; if (HAL_UART_Init(&huart2) != HAL_OK) { Error_Handler(); } } 步骤2：添加头文件 添加头文件#include "stdio.h" 步骤3：重定向_C使用的I/O到串口函数 int __io_putchar(int ch){ HAL_UART_Transmit(&huart2, (uint8_t*)&ch, 1, HAL_MAX_DELAY); return ch; } int __io_getchar(void){ uint8_t ch = 0; HAL_UART_Receive(&huart2, &ch, 1, HAL_MAX_DELAY); return ch; } 步骤4：PRINTF使用到串口 下面的代码演示了如何在STM32 HAL库中使用PRINTF函数： #include "main.h" int main(void){ HAL_Init(); /* Configure the system clock */ SystemClock_Config(); /* Initialize all configured peripherals */ MX_USART2_UART_Init(); printf("Hello World!\n\r"); while (1){} } 总结 通过重定向printf流到UART串口，可以方便地在开发STM32中使用printf输出调试信息。但使用printf有一定的缺点，它是在实时系统中使用的较为耗时函数。这是因为printf函数必须解析格式字符串，并调用适当的转换函数。为了避免这个问题，最好使用半主动的方法使用日志输出，例如printf之类的函数，通过缓冲区进行输出，或将输出设置为仅在发现问题时才进行输出。这样可以提高代码执行效率，同时也可以提供相应的实时能力。 ### 回答3： STM32 HAL库是一套由STMicroelectronics公司推出的一种开发工具，能够简化STM32系列单片机的应用程序开发过程。在HAL库中，使用printf函数能够方便的打印各种数据信息，但是在使用printf函数之前，需要进行一些配置。 首先，在使用printf函数之前，需要配置USART串口通信的参数，例如波特率、数据位、停止位、奇偶校验位等，这些参数需要根据具体的串口硬件进行设置。我们可以在MX_GPIO_Init函数中配置串口管脚的引脚和模式，在MX_USART2_UART_Init函数中配置USART串口通信的参数。 其次，需要开启printf函数的内存输出模式。在代码中，我们需要加入一行语句“setvbuf(stdout, NULL, _IONBF, 0);”，这样可以将输出重定向到内存中。这是因为，printf函数默认是将数据输出到stdout流中，而stdout流默认是以缓存方式进行输出，需要使用setvbuf函数进行缓存设置，这里我们将缓存区设置为NULL，表示不进行缓存，直接输出到内存中。 最后，还需要编写一个函数putchar（或者重定向printf函数），将输出的数据读取出来，发送到串口中进行实际输出。我们可以在主程序中编写一个简单的死循环，循环中调用putchar函数，将内存中的数据读取出来，发送到串口中实现实际输出。 综上所述，使用printf函数需要进行串口通信的参数配置、内存输出模式设置和实际输出函数编写。这些步骤都比较繁琐，但是通过HAL库的封装，大大简化了代码编写的复杂性，提高了开发效率。除了printf函数，HAL库还包含其他丰富的函数库，可以方便的进行GPIO控制、定时器设置、中断处理等功能，适用于各种STM32系列单片机应用程序开发。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 3
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值