代码收藏家技术教程 2025-06-15

单片机串口打印调试信息详解与操作指南①

在单片机开发中，通过串口（UART）输出调试信息是最常用的调试方法之一。以下是详细的操作指南，包括硬件连接、代码实现和调试信息规划策略：

一、硬件连接与配置

硬件准备：
USB转TTL模块：连接单片机的UART引脚（TX/RX）到电脑，注意电平匹配（3.3V或5V）。
接线示例：
单片机TX → USB转TTL模块RX
单片机RX → USB转TTL模块TX
共地（GND连接）。
调试工具：使用串口助手（如PuTTY、SecureCRT或Arduino IDE串口监视器）。
串口参数配置：
波特率：常用9600、115200（需与代码配置一致）。
数据格式：8位数据位、1位停止位、无校验位（8N1）。

二、代码实现

步骤1：初始化串口

以STM32 HAL库为例：

// 初始化UART2（PA2-TX，PA3-RX）
UART_HandleTypeDef huart2;

void 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;
  HAL_UART_Init(&huart2);
}

步骤2：实现打印函数

重定向printf到串口（需开启MicroLIB库）：

#include <stdio.h>

// 重定向putchar函数
int __io_putchar(int ch) {
  HAL_UART_Transmit(&huart2, (uint8_t*)&ch, 1, 1000);
  return ch;
}

// 使用示例
printf("System Boot OK. Clock: %d Hz\r\n", SystemCoreClock);

替代方案：直接发送数据

void UART_SendString(char *str) {
  HAL_UART_Transmit(&huart2, (uint8_t*)str, strlen(str), 1000);
}

// 使用示例
UART_SendString("ADC Value: 1023\r\n");

三、调试信息的规划

1. 何时打印？

系统启动时：确认初始化状态。

printf("[INIT] Clock: %d Hz, Flash: %d KB\r\n", ...);

关键函数入口/出口：

void ADC_Read() {
  printf("> ADC_Read Enter\r\n");
  // ...代码逻辑
  printf("< ADC_Read Exit (val=%d)\r\n", value);
}

错误处理分支：

if (HAL_I2C_Read(...) != HAL_OK) {
  printf("[ERROR] I2C Read Failed (Addr:0x%02X)\r\n", dev_addr);
}

定时心跳包（可选）：

while(1) {
  printf("[HEARTBEAT] System Running: %ld ms\r\n", HAL_GetTick());
  HAL_Delay(1000);
}

2. 打印什么内容？

变量值：实时监控关键变量。

printf("Temperature: %.1f°C\r\n", temp);

执行流程：标记代码执行路径。

printf("--> Enter Main Loop\r\n");

时间戳：分析事件间隔。

uint32_t start = HAL_GetTick();
// ...代码逻辑
printf("Function Time Cost: %ld ms\r\n", HAL_GetTick() - start);

错误码与上下文：

printf("[ERROR] SD Card Init Failed (Code:%d, Sector:%d)\r\n", err_code, sector);

数据校验（如通信协议）：

printf("Received Data: ");
for (int i=0; i<len; i++) printf("%02X ", buffer[i]);
printf("\r\n");

四、调试优化技巧

条件编译控制：

#define DEBUG 1  // 发布时设为0关闭日志

#if DEBUG
  #define DEBUG_PRINTF(...) printf(__VA_ARGS__)
#else
  #define DEBUG_PRINTF(...)
#endif

// 使用示例
DEBUG_PRINTF("Debug Message\r\n");

多级日志分级：

#define LOG_LEVEL_INFO    1
#define LOG_LEVEL_WARNING 2
#define LOG_LEVEL_ERROR   3

void log_message(int level, const char *format, ...) {
  if (level >= CURRENT_LOG_LEVEL) {
    va_list args;
    va_start(args, format);
    vprintf(format, args);
    va_end(args);
  }
}

环形缓冲区（避免阻塞）：
使用DMA或中断发送，避免HAL_UART_Transmit阻塞CPU。
示例：STM32CubeMX配置UART的DMA发送模式。

五、常见问题解决

无输出或乱码：
检查波特率是否一致。
确认时钟配置（如STM32的APB1/APB2总线时钟是否使能UART）。
检查TX/RX接线是否交叉连接。
打印导致程序卡死：
避免在中断服务函数中直接调用printf（改用标志位+主循环打印）。
使用非阻塞发送（如HAL_UART_Transmit_IT）。
数据量过大：
启用DMA传输（STM32CubeMX中配置UART DMA通道）。
减少冗余日志（如仅在错误时打印详细数据）。

六、高级替代方案

SWO输出（ARM Cortex-M）：
通过SWD接口输出调试信息，不占用UART资源。
需使用J-Link调试器和SWO Viewer工具。
ITM（Instrumentation Trace Macrocell）：
在Keil或IAR中直接查看ITM Data Console。

示例代码：

ITM_SendChar('A');  // 直接发送字符到调试器

总结

操作流程：

硬件连接 → 2. 配置UART → 3. 重定向printf → 4. 在关键节点添加打印 → 5. 通过串口助手观察输出。

调试原则：

精准定位：在怀疑出问题的代码段前后添加日志。

信息分层：区分INFO/WARNING/ERROR级别日志。

最小侵入：通过宏定义实现日志开关，避免影响正式版本性能。

作者：Aurora Smith

物联沃分享整理
物联沃-IOTWORD物联网 » 单片机串口打印调试信息详解与操作指南①

代码收藏家普通

分享到：