当前位置：首页 > news >正文

单片机串口打印调试信息①

news 来源：原创 2025/5/13 18:39:51

在单片机开发中，通过串口（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');  // 直接发送字符到调试器
```