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

嵌入式开发调试信息输出方法详解

news 2026/5/12 19:32:45

嵌入式开发输出调试信息的几种实用方法

1. 调试信息输出的重要性

在嵌入式系统开发过程中，调试信息的输出是定位问题和验证功能的关键手段。当系统出现异常行为时，缺乏有效的调试信息往往会使问题排查变得异常困难。然而，嵌入式系统通常具有以下特点：

可能没有操作系统支持
往往缺乏文件系统
资源受限（内存、存储空间等）
实时性要求高

这些特点使得传统的基于文件的日志记录方法在嵌入式环境中难以适用。本文将详细介绍几种在嵌入式开发中实际验证过的调试信息输出方法。

2. SRAM缓冲区日志输出

2.1 基本原理

当目标芯片尚未实现串口驱动或串口被占用时，可以将调试信息输出到SRAM中的环形缓冲区。这种方法的核心思想是：

在SRAM中分配固定大小的缓冲区
将调试信息写入缓冲区
通过调试器查看缓冲区内容

2.2 实现方案

首先定义日志设备结构体：

typedef struct { volatile u8 type; u8* buffer; /* log buffer指针 */ volatile u32 write_idx; /* log写入位置 */ volatile u32 read_idx; /* log读取位置 */ } log_dev;

分配1KB的SRAM空间作为日志缓冲区：

static u8 log_buffer[LOG_MAX_LEN];

实现printf重定向：

#include <stdio.h> // redirect fputc int fputc(int ch, FILE *f) { print_ch((u8)ch); return ch; }

数据写入SRAM的实现：

/* write log to bufffer or I/O */ void print_ch(u8 ch) { log_dev_ptr->buffer[log_dev_ptr->write_idx++] = ch; if (log_dev_ptr->write_idx >= LOG_MAX_LEN) { log_dev_ptr->write_idx = 0; } }

2.3 优缺点分析

优点：

不依赖任何外设
实现简单
适用于芯片开发初期

缺点：

缓冲区容量有限，日志可能被覆盖
需要连接调试器查看
不适合长期运行的系统

3. 通过SWO输出调试信息

3.1 SWO技术原理

SWO（Serial Wire Output）是ARM Cortex-M系列处理器提供的调试功能，它通过单线输出调试信息，具有以下特点：

不占用额外GPIO
不影响程序执行
带宽高于普通串口

3.2 实现方法

扩展日志设备结构体：

typedef struct { u8 (*init)(void* arg); u8 (*print)(u8 ch); u8 (*print_dma)(u8* buffer, u32 len); } log_func; typedef struct { volatile u8 type; u8* buffer; volatile u32 write_idx; volatile u32 read_idx; // SWO log_func* swo_log_func; } log_dev;

SWO输出函数实现：

u8 swo_print_ch(u8 ch) { ITM_SendChar(ch); return 0; }

3.3 查看SWO输出

3.3.1 通过IDE查看

在Keil MDK中需要进行以下配置：

打开"Debug"配置
启用"Trace"功能
设置正确的Core Clock频率
启用ITM端口0

3.3.2 通过ST-LINK Utility查看

打开ST-LINK菜单
选择"Printf via SWO viewer"
点击"Start"按钮

4. 串口输出调试信息

4.1 基本串口输出

串口输出是最常用的调试信息输出方式，实现简单且通用性强。典型的串口初始化代码如下：

void uart_init(u32 baudrate) { GPIO_InitTypeDef GPIO_InitStructure; USART_InitTypeDef USART_InitStructure; RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1Periph_USART2, ENABLE); GPIO_PinAFConfig(GPIOA, GPIO_PinSource2, GPIO_AF_USART2); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_2; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_OType = GPIO_OType_PP; GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP; GPIO_Init(GPIOA, &GPIO_InitStructure); USART_InitStructure.USART_BaudRate = baudrate; 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_Tx; USART_Init(USART2, &USART_InitStructure); USART_Cmd(USART2, ENABLE); }

4.2 DMA增强型串口输出

为解决串口输出占用CPU时间过长的问题，可以使用DMA将数据从内存传输到串口：

u8 uart_print_dma(u8* buffer, u32 len) { if ((DMA1_Stream6->CR & DMA_SxCR_EN) != RESET) { return 1; // DMA忙 } if (DMA_GetFlagStatus(DMA1_Stream6, DMA_IT_TCIF6) != RESET) { DMA_ClearFlag(DMA1_Stream6, DMA_FLAG_TCIF6); DMA_Cmd(DMA1_Stream6, DISABLE); } DMA_SetCurrDataCounter(DMA1_Stream6, len); DMA_MemoryTargetConfig(DMA1_Stream6, (u32)buffer, DMA_Memory_0); DMA_Cmd(DMA1_Stream6, ENABLE); return 0; }

DMA配置关键点：

正确设置DMA通道和流（USART2_TX对应DMA1 Stream6 Channel4）
配置为内存到外设传输
启用内存地址递增
设置合适的中断优先级

5. GPIO模拟串口输出

5.1 应用场景

当芯片没有可用串口或所有串口都被占用时，可以通过普通GPIO模拟UART协议输出调试信息。这种方法适用于：

封装中没有引出串口引脚
系统资源极度受限
临时调试需求

5.2 实现要点

UART协议基本时序：

起始位（低电平）
8位数据位（LSB first）
停止位（高电平）

定时器初始化（产生精确延时）：

u8 simu_log_init(void* arg) { TIM_TimeBaseInitTypeDef TIM_InitStructure; u32* bound = (u32*)arg; GPIO_InitTypeDef GPIO_InitStructure; RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_2; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_OType = GPIO_OType_PP; GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP; GPIO_Init(GPIOA, &GPIO_InitStructure); GPIO_SetBits(GPIOA, GPIO_Pin_2); RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM4, ENABLE); TIM_DeInit(TIM4); TIM_InitStructure.TIM_Prescaler = 1; TIM_InitStructure.TIM_CounterMode = TIM_CounterMode_Up; TIM_InitStructure.TIM_Period = 41; // 1us timer TIM_InitStructure.TIM_ClockDivision = TIM_CKD_DIV1; TIM_TimeBaseInit(TIM4, &TIM_InitStructure); TIM_ClearFlag(TIM4, TIM_FLAG_Update); baud_delay = 1000000/(*bound); // 计算每个bit的延时 return 0; }

模拟输出函数：

u8 simu_print_ch(u8 ch) { volatile u8 i=8; __asm("cpsid i"); // 关闭中断 // 起始位 GPIO_ResetBits(GPIOA, GPIO_Pin_2); simu_delay(baud_delay); while(i--) { if(ch & 0x01) GPIO_SetBits(GPIOA, GPIO_Pin_2); else GPIO_ResetBits(GPIOA, GPIO_Pin_2); ch >>= 1; simu_delay(baud_delay); } // 停止位 GPIO_SetBits(GPIOA, GPIO_Pin_2); simu_delay(baud_delay); simu_delay(baud_delay); __asm("cpsie i"); // 开启中断 return 0; }

6. 方法比较与选择建议

方法	适用场景	优点	缺点
SRAM缓冲区	芯片开发初期，无串口驱动	不依赖外设，实现简单	需要调试器，容量有限
SWO输出	ARM Cortex-M芯片调试	不占用GPIO，不影响程序执行	需要特定调试器支持
串口输出	常规调试场景	通用性强，实现简单	占用串口资源，可能影响时序
DMA串口输出	高实时性要求的系统	几乎不影响CPU性能	实现较复杂，占用DMA资源
GPIO模拟串口	无可用串口时的应急方案	灵活，不依赖特定外设	精度低，占用CPU资源多