STM32串口打印实战：从基础配置到高级应用

1. 正点原子STM32精英V2开发板串口打印基础

正点原子STM32精英V2开发板是一款基于STM32F103ZET6芯片的高性能开发板，广泛应用于嵌入式系统学习和开发。串口打印功能是嵌入式开发中最基础也是最重要的调试手段之一，它可以帮助开发者实时查看程序运行状态和调试信息。

1.1 硬件连接准备

在使用串口打印功能前，我们需要确保硬件连接正确。精英V2开发板上有两个USART接口（USART1和USART2），其中USART1通过板载的CH340G芯片转换为USB接口，可以直接通过USB线连接到电脑。

具体连接步骤如下：

1. 使用Micro USB线连接开发板的USB转串口接口（标有"USB转串口"的接口）到电脑
2. 确保开发板供电正常（可以通过板载的电源指示灯判断）
3. 在电脑设备管理器中查看是否识别到CH340G串口设备

注意：如果电脑无法识别CH340G设备，可能需要安装对应的驱动程序。正点原子提供的资料包中通常包含这个驱动。

1.2 开发环境配置

为了在Keil MDK开发环境中使用串口打印功能，我们需要进行以下配置：

1. 确保已安装STM32F1系列的设备支持包
2. 在工程选项中正确配置芯片型号为STM32F103ZE
3. 设置正确的调试器选项（根据使用的调试工具选择，如ST-Link或J-Link）
4. 在工程属性中勾选"Use MicroLIB"选项，这是使用printf函数的关键设置

2. 串口初始化与重定向printf

2.1 USART初始化代码实现

在STM32中，使用串口打印需要先初始化USART外设。以下是USART1的初始化代码示例：

#include "stm32f10x.h" void USART1_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; USART_InitTypeDef USART_InitStructure; // 使能USART1和GPIOA时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1 | RCC_APB2Periph_GPIOA, ENABLE); // 配置USART1 Tx (PA9)为复用推挽输出 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); // 配置USART1 Rx (PA10)为浮空输入 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, &GPIO_InitStructure); // USART参数配置 USART_InitStructure.USART_BaudRate = 115200; USART_InitStructure.USART_WordLength = USART_WordLength_8b; USART_InitStructure.USART_StopBits = USART_StopBits_1; USART_InitStructure.USART_Parity = USART_Parity_No; USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None; USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, &USART_InitStructure); USART_Cmd(USART1, ENABLE); }

2.2 printf函数重定向

STM32默认不支持直接使用printf函数输出到串口，需要通过重定向fputc函数来实现：

#include <stdio.h> int fputc(int ch, FILE *f) { // 等待上一个字节发送完成 while(USART_GetFlagStatus(USART1, USART_FLAG_TC) == RESET); // 发送字节到USART1 USART_SendData(USART1, (uint8_t)ch); return ch; }

提示：重定向printf函数时，务必确保在工程设置中勾选了"Use MicroLIB"选项，否则重定向可能不会生效。

3. 串口调试工具使用与优化

3.1 串口调试助手的选择与配置

市面上有多种串口调试工具可供选择，正点原子也提供了自己的串口调试助手。以下是常用的串口调试工具：

1. 正点原子串口调试助手
2. SecureCRT
3. Putty
4. Tera Term
5. 友善串口助手

配置串口调试工具时需要注意以下参数：

• 波特率：必须与程序中设置的波特率一致（通常为115200）
• 数据位：8位
• 停止位：1位
• 校验位：无
• 流控：无

3.2 打印输出优化技巧

在实际开发中，我们可以对打印输出进行优化，提高调试效率：

1. 添加时间戳：在打印信息前添加系统运行时间

printf("[%08lu] System started\n", HAL_GetTick());

2. 使用颜色区分不同级别的信息（如果终端支持ANSI颜色）

#define LOG_ERROR "\033[31m[ERROR]\033[0m " #define LOG_INFO "\033[32m[INFO ]\033[0m " printf(LOG_ERROR "Failed to initialize device\n"); printf(LOG_INFO "System initialized successfully\n");

3. 条件编译控制打印输出

#define DEBUG 1 #if DEBUG #define DBG_PRINTF(...) printf(__VA_ARGS__) #else #define DBG_PRINTF(...) #endif

4. 常见问题与解决方案

4.1 串口无输出问题排查

当串口没有输出时，可以按照以下步骤排查：

1. 检查硬件连接是否正确

   • USB线是否连接到了正确的接口
   • 开发板供电是否正常
   • 串口线是否完好

2. 检查电脑端设置

   • 设备管理器中是否识别到串口设备
   • 串口调试工具是否选择了正确的COM口
   • 波特率等参数是否设置正确

3. 检查代码配置

   • USART初始化是否正确
   • 时钟配置是否正确
   • printf重定向是否实现
   • 工程中是否勾选了"Use MicroLIB"

4. 检查终端电阻

   • 某些情况下可能需要连接终端电阻

4.2 打印输出乱码问题

打印输出出现乱码通常由以下原因导致：

1. 波特率不匹配

   • 确保程序中设置的波特率与串口调试工具设置的完全一致
   • 检查系统时钟配置是否正确，因为波特率计算依赖于系统时钟

2. 时钟源配置错误

   • STM32的USART时钟源可能来自APB1或APB2总线
   • 确保时钟树配置正确，特别是使用外部晶振时

3. 数据格式不一致

   • 检查程序中USART的数据位、停止位、校验位设置
   • 确保与串口调试工具中的设置一致

4. 电磁干扰

   • 长距离传输时可能出现信号质量问题
   • 可以尝试降低波特率或使用屏蔽线

4.3 性能优化建议

1. 减少字符串长度：过长的字符串会占用大量传输时间
2. 使用DMA传输：对于大量数据输出，可以使用DMA减轻CPU负担
3. 缓冲输出：实现一个环形缓冲区，避免阻塞式等待
4. 异步打印：在RTOS环境中，可以创建一个专门的打印任务

5. 高级应用与扩展

5.1 多串口同时使用

精英V2开发板上有多个USART接口，我们可以同时使用多个串口：

// 初始化USART2 void USART2_Init(void) { // 类似USART1的初始化代码 // 注意USART2通常使用GPIOA的PA2(TX)和PA3(RX) // 时钟来自APB1总线，最大波特率较低 } // 重定向特定文件的输出到USART2 int fputc2(int ch, FILE *f) { while(USART_GetFlagStatus(USART2, USART_FLAG_TC) == RESET); USART_SendData(USART2, (uint8_t)ch); return ch; } // 使用示例 FILE *uart2 = fopen("uart2", "w"); fprintf(uart2, "This goes to USART2\n");

5.2 使用RTOS时的串口打印

在FreeRTOS等实时操作系统中使用串口打印需要注意线程安全问题：

// 创建一个互斥锁保护串口资源 SemaphoreHandle_t uart_mutex; void vPrintString(const char *str) { xSemaphoreTake(uart_mutex, portMAX_DELAY); printf("%s", str); xSemaphoreGive(uart_mutex); } // 初始化时创建互斥锁 uart_mutex = xSemaphoreCreateMutex();

5.3 实现日志系统

基于串口打印，我们可以构建一个简单的日志系统：

typedef enum { LOG_LEVEL_DEBUG, LOG_LEVEL_INFO, LOG_LEVEL_WARNING, LOG_LEVEL_ERROR } LogLevel; void log_message(LogLevel level, const char *format, ...) { static const char *level_str[] = { "DEBUG", "INFO", "WARN", "ERROR" }; va_list args; va_start(args, format); printf("[%08lu][%s] ", HAL_GetTick(), level_str[level]); vprintf(format, args); printf("\n"); va_end(args); } // 使用示例 log_message(LOG_LEVEL_INFO, "System initialized, free memory: %d bytes", get_free_memory());

6. 实际项目中的应用案例

6.1 传感器数据采集与显示

在物联网项目中，我们经常需要通过串口显示传感器数据：

void task_sensor_read(void *pvParameters) { while(1) { float temperature = read_temperature(); float humidity = read_humidity(); printf("Temperature: %.2f°C, Humidity: %.2f%%\n", temperature, humidity); vTaskDelay(pdMS_TO_TICKS(1000)); } }

6.2 设备状态监控

串口打印可以用于实时监控设备状态：

void monitor_system_status(void) { printf("==== System Status ====\n"); printf("CPU Usage: %d%%\n", get_cpu_usage()); printf("Free Memory: %d bytes\n", get_free_memory()); printf("Task Count: %d\n", get_task_count()); printf("Uptime: %lu seconds\n", HAL_GetTick()/1000); }

6.3 固件升级过程中的调试信息

在实现OTA升级功能时，串口打印可以提供重要的调试信息：

void firmware_update(void) { printf("[FW Update] Starting update process\n"); if(connect_to_server()) { printf("[FW Update] Connected to update server\n"); int size = get_firmware_size(); printf("[FW Update] New firmware size: %d bytes\n", size); if(flash_erase()) { printf("[FW Update] Flash erased successfully\n"); if(download_and_flash()) { printf("[FW Update] Firmware updated successfully\n"); return; } } } printf("[FW Update] Update failed!\n"); }

在实际开发中，我发现合理组织串口打印信息可以极大提高调试效率。建议按照功能模块对打印信息进行分类，并使用一致的格式。对于长期运行的产品，可以考虑实现日志分级控制，在发布版本中关闭调试信息以减少开销。