STM32串口调试：printf重定向实现方法

博主：小蓝
发布时间：2025 年 02 月 04 日
227 次浏览
暂无评论
2003字数
分类： Linux 技术杂烩

### STM32串口调试：`printf`重定向实现方法

在嵌入式开发中，`printf`是一个常用的调试工具，帮助开发人员输出调试信息。但在STM32等微控制器中，由于没有标准的输入输出接口（如LCD屏或键盘），通常需要将 `printf`的输出重定向到串口（UART）进行调试。这篇文章将详细介绍如何在STM32上实现 `printf`的串口重定向。

### 1. **为什么要重定向printf?**

在STM32中，标准库函数 `printf`默认是通过终端输出到屏幕上的。但由于STM32没有直接的显示硬件或控制台输出设备，无法直接使用标准的 `printf`输出。在这种情况下，`printf`函数的输出必须被“重定向”到串口（UART），这样开发人员可以通过串口调试工具（如Tera Term、PuTTY等）接收和查看输出信息。

### 2. **基本原理**

`printf`函数是通过 `low-level` 输出函数（如 `putchar`）来实现字符输出的。在嵌入式系统中，我们可以通过重定义 `putchar` 函数，使其将字符输出发送到STM32的串口上。具体的操作步骤如下：

* **`printf`函数输出字符**：`printf`函数调用 `putchar` 来输出字符。
* **重定向 `putchar`**：我们重定向 `putchar` 函数，使其通过串口发送字符数据。

### 3. **实现步骤**

下面是实现STM32串口调试时重定向 `printf`的详细步骤：

#### 3.1 **初始化串口（UART）**

首先，需要初始化STM32的串口（UART），以便通过串口传输数据。以STM32的USART1为例，初始化代码如下：

```c
#include "stm32f4xx.h"

void USART1_Init(void)
{
    // 使能USART1时钟
    RCC->APB2ENR |= RCC_APB2ENR_USART1EN;
    RCC->AHB1ENR |= RCC_AHB1ENR_GPIOAEN;

// 设置PA9为USART1_TX, PA10为USART1_RX
    GPIOA->MODER |= (0x02 << (2 * 9)) | (0x02 << (2 * 10)); // 设置为复用模式
    GPIOA->AFR[1] |= (0x07 << (4 * (9 - 8))) | (0x07 << (4 * (10 - 8))); // 设置AF7

// 配置USART1
    USART1->BRR = 0x0683; // 波特率9600 (USARTDIV = 9600)
    USART1->CR1 = USART_CR1_UE | USART_CR1_TE | USART_CR1_RE; // 启用USART, 发送和接收使能
}
```

在上述代码中，我们使能了USART1和GPIOA的时钟，并设置了PA9和PA10为USART1的TX/RX引脚。

#### 3.2 **重定向 `printf`函数**

接下来，重定向 `printf`函数，使其通过USART1发送字符。我们需要重定义 `putchar` 函数，让它通过串口发送字符。

```c
#include <stdio.h>

int fputc(int ch, FILE *f)
{
    // 等待USART1数据寄存器空闲
    while (!(USART1->SR & USART_SR_TXE));
    // 发送字符
    USART1->DR = (ch & 0xFF);
    return ch;
}
```

在这里，`fputc` 是C标准库函数，在调用 `printf`时，字符将逐个传入该函数。我们在函数内通过 `USART1->DR` 寄存器将字符发送出去。

#### 3.3 **调用 `printf`函数进行调试**

完成上述配置后，你就可以像平常一样在程序中调用 `printf` 函数进行调试输出了。以下是一个简单的示例：

```c
int main(void)
{
    USART1_Init(); // 初始化USART1

printf("Hello, STM32!\n"); // 使用printf进行调试输出

while (1)
    {
        // 主循环
    }
}
```

此时，`printf`会将输出的内容通过USART1串口发送，你可以通过串口调试工具接收并显示这些信息。

### 4. **常见问题与解决方法**

#### 4.1 **`printf`没有输出**

1. **串口初始化错误**：检查串口初始化函数是否正确，确保波特率和引脚配置无误。
2. **串口连接问题**：确保你使用的串口调试工具（如Tera Term）已经正确连接并选择了正确的串口号。
3. **硬件连接问题**：检查STM32的TX引脚是否正确连接到电脑的RX端。

#### 4.2 **串口输出乱码**

1. **波特率设置不匹配**：确保串口的波特率配置与开发板设置一致。
2. **数据位、停止位等配置错误**：检查数据位、停止位等参数是否正确配置。

### 5. **总结**

通过上述方法，我们可以轻松地将STM32的 `printf`输出重定向到串口（UART），从而实现嵌入式系统中的串口调试。整个过程主要通过重定义 `putchar`函数，使其通过串口发送字符数据。调试过程中，我们可以通过串口调试工具查看输出结果，帮助快速定位问题。

重定向 `printf`到串口是嵌入式开发中常见的调试技巧，掌握这个技能对于嵌入式开发中的问题排查非常重要。

蓝易云是一家专注于香港及国内数据中心服务的提供商，提供高质量的服务器租用和云计算服务、包括免备案香港服务器、香港CN2、美国服务器、海外高防服务器、国内高防服务器、香港VPS等。致力于为用户提供稳定,快速的网络连接和优质的客户体验。

最后修改：2025 年 02 月 04 日

如果觉得我的文章对你有用，请随意赞赏

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

评论 *

私密评论

名称 *

🎲

邮箱 *

地址

STM32串口调试：printf重定向实现方法

小蓝 • 2025 年 02 月 04 日

### STM32串口调试：`printf`重定向实现方法

### 1. **为什么要重定向printf?**

### 2. **基本原理**

* **`printf`函数输出字符**：`printf`函数调用 `putchar` 来输出字符。
* **重定向 `putchar`**：我们重定向 `putchar` 函数，使其通过串口发送字符数据。

### 3. **实现步骤**

下面是实现STM32串口调试时重定向 `printf`的详细步骤：

#### 3.1 **初始化串口（UART）**

首先，需要初始化STM32的串口（UART），以便通过串口传输数据。以STM32的USART1为例，初始化代码如下：

```c
#include "stm32f4xx.h"

void USART1_Init(void)
{
    // 使能USART1时钟
    RCC->APB2ENR |= RCC_APB2ENR_USART1EN;
    RCC->AHB1ENR |= RCC_AHB1ENR_GPIOAEN;

// 配置USART1
    USART1->BRR = 0x0683; // 波特率9600 (USARTDIV = 9600)
    USART1->CR1 = USART_CR1_UE | USART_CR1_TE | USART_CR1_RE; // 启用USART, 发送和接收使能
}
```

在上述代码中，我们使能了USART1和GPIOA的时钟，并设置了PA9和PA10为USART1的TX/RX引脚。

#### 3.2 **重定向 `printf`函数**

接下来，重定向 `printf`函数，使其通过USART1发送字符。我们需要重定义 `putchar` 函数，让它通过串口发送字符。

```c
#include <stdio.h>

int fputc(int ch, FILE *f)
{
    // 等待USART1数据寄存器空闲
    while (!(USART1->SR & USART_SR_TXE));
    // 发送字符
    USART1->DR = (ch & 0xFF);
    return ch;
}
```

在这里，`fputc` 是C标准库函数，在调用 `printf`时，字符将逐个传入该函数。我们在函数内通过 `USART1->DR` 寄存器将字符发送出去。

#### 3.3 **调用 `printf`函数进行调试**

完成上述配置后，你就可以像平常一样在程序中调用 `printf` 函数进行调试输出了。以下是一个简单的示例：

```c
int main(void)
{
    USART1_Init(); // 初始化USART1

printf("Hello, STM32!\n"); // 使用printf进行调试输出

while (1)
    {
        // 主循环
    }
}
```

此时，`printf`会将输出的内容通过USART1串口发送，你可以通过串口调试工具接收并显示这些信息。

### 4. **常见问题与解决方法**

#### 4.1 **`printf`没有输出**

#### 4.2 **串口输出乱码**

1. **波特率设置不匹配**：确保串口的波特率配置与开发板设置一致。
2. **数据位、停止位等配置错误**：检查数据位、停止位等参数是否正确配置。

### 5. **总结**

重定向 `printf`到串口是嵌入式开发中常见的调试技巧，掌握这个技能对于嵌入式开发中的问题排查非常重要。

STM32串口调试：printf重定向实现方法

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

微信视频号视频下载工具WeChatVideoDownloader

Win11系统优化工具-Windows11一键设置

YDArk - 系统内核工具

XPay-自建个人免签收款支付系统

Windows微软常用运行库合集一键安装

解决SpringBoot项目war部署到tomcat下无法Nacos中注册服务问题

python asyncio框架中asyncio.gather方法的并发控制策略

MySQL数据库分页查询的三种效率方法

常用SpringBoot注解汇总与用法说明

SpringBoot2 高级特性：Starter 依赖管理机制解析

STM32串口调试：printf重定向实现方法

发表评论 取消回复 使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

STM32串口调试：printf重定向实现方法

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款