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

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

---

一、硬件连接与配置

1. 硬件准备：

   • USB转TTL模块：连接单片机的UART引脚（TX/RX）到电脑，注意电平匹配（3.3V或5V）。

   • 接线示例：

     • 单片机TX → USB转TTL模块RX

     • 单片机RX → USB转TTL模块TX

     • 共地（GND连接）。

   • 调试工具：使用串口助手（如PuTTY、SecureCRT或Arduino IDE串口监视器）。

2. 串口参数配置：

   • 波特率：常用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 
​
// 重定向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 
      

---

四、调试优化技巧

1. 条件编译控制：

   #define DEBUG 1  // 发布时设为0关闭日志
   ​
   #if DEBUG
     #define DEBUG_PRINTF(...) printf(__VA_ARGS__)
   #else
     #define DEBUG_PRINTF(...)
   #endif
   ​
   // 使用示例
   DEBUG_PRINTF("Debug Message\r\n");

2. 多级日志分级：

   #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);
     }
   }

3. 环形缓冲区（避免阻塞）：

   • 使用DMA或中断发送，避免HAL_UART_Transmit阻塞CPU。

   • 示例：STM32CubeMX配置UART的DMA发送模式。

---

五、常见问题解决

1. 无输出或乱码：

   • 检查波特率是否一致。

   • 确认时钟配置（如STM32的APB1/APB2总线时钟是否使能UART）。

   • 检查TX/RX接线是否交叉连接。

2. 打印导致程序卡死：

   • 避免在中断服务函数中直接调用printf（改用标志位+主循环打印）。

   • 使用非阻塞发送（如HAL_UART_Transmit_IT）。

3. 数据量过大：

   • 启用DMA传输（STM32CubeMX中配置UART DMA通道）。

   • 减少冗余日志（如仅在错误时打印详细数据）。

---

六、高级替代方案

1. SWO输出（ARM Cortex-M）：

   • 通过SWD接口输出调试信息，不占用UART资源。

   • 需使用J-Link调试器和SWO Viewer工具。

2. ITM（Instrumentation Trace Macrocell）：

   • 在Keil或IAR中直接查看ITM Data Console。

   • 示例代码：

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

---

总结

操作流程：

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

调试原则：

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

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

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