没有串口,如何打印单片机调试信息?
輸出調試信息是嵌入式開發中必不可少的調試利器,嵌入式開發的一個特點是很多時候沒有操作系統,或者沒有文件系統,常規的打印log到文件的方法基本不適用。
最常用的是通過串口輸出uart log,例如51單片機,只要實現串口驅動,通過串口輸出就可以了。
串口這種方法實現簡單,大部分嵌入式芯片都有串口功能。但是這樣簡單的功能有時候卻不是那么好用,比如:
一款新拿到的芯片,沒有串口驅動時如何打印log?
某些應用下對時序要求比較高,串口輸出log占用時間太長怎么辦?比如usb枚舉。
某些bug正常運行時會出現,當打開串口log時又不再復現怎么辦?
一些封裝中沒有串口,或者串口已經被用作其他用途,要如何輸出log?
本文介紹單片機沒有串口時,如何打印調試信息。
1 輸出log信息到SRAM
準確來說這里并不是輸出log,而是以一種方式不使用串口就可以看到log。在芯片開發階段都可以連接仿真器調試,可以使用打斷點的方法調試,但是有些操作如果不能被打斷就沒法使用斷點調試了。這時候可以考慮將log打印到SRAM中,整個操作結束后再通過仿真器查看SRAM中的log buffer,這樣就實現了間接的log輸出。
本文使用的測試平臺是stm32f407 discovery,基于usb host實驗代碼,對于其他嵌入式平臺原理也是通用的。
首先定義一個結構體用于打印log,如下:
typedef struct {volatile u8 type;u8* buffer; /* log buffer指針*/volatile u32 write_idx; /* log寫入位置*/volatile u32 read_idx; /* log 讀取位置*/ }log_dev;定義一段SRAM空間作為log buffer
static u8 log_buffer[LOG_MAX_LEN];log buffer是環形緩沖區,在小的buffer就可以無限打印log,缺點也很明顯,如果log沒有及時輸出就會被新的覆蓋。Buffer大小根據SRAM大小分配,這里使用1kB。
為了方便輸出參數,使用printf函數來格式化輸出,需要做如下配置。
并包含頭文件#include <stdio.h>, 在代碼中實現函數fputc()。
//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;} }為了方便控制log打印格式,在頭文件中再添加自定義的打印函數:
#ifdef DEBUG_LOG_EN #define DEBUG(...) printf("usb_printer:"__VA_ARGS__) #else #define DEBUG(...) #endif在需要打印log的地方直接調用DEBUG()即可,最終效果如下,從Memory窗口可以看到打印的log:
通過SWO輸出log
通過打印log到SRAM的方式可以看到log,但是數據量多的時候可能來不及查看就被覆蓋了。為了解決這個問題,可以使用St-link的SWO輸出log,這樣就不用擔心log被覆蓋。
在log結構體中添加SWO的操作函數集:
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;//SWOlog_func* swo_log_func; }log_dev;SWO只需要print操作函數,實現如下:
u8 swo_print_ch(u8 ch) {ITM_SendChar(ch);return 0; }使用SWO輸出log同樣先輸出到log buffer,然后在系統空閑時再輸出,當然也可以直接輸出。log延遲輸出會影響log的實時性,而直接輸出會影響到對時間敏感的代碼運行,所以如何取舍取決于需要輸出log的情形。在while循環中調用output_ch()函數,就可以實現在系統空閑時輸出log。
/*output log buffer to I/O*/ void output_ch(void) { u8 ch;volatile u32 tmp_write,tmp_read;tmp_write = log_dev_ptr->write_idx;tmp_read = log_dev_ptr->read_idx;if(tmp_write != tmp_read){ch = log_dev_ptr->buffer[tmp_read++];//swoif(log_dev_ptr->swo_log_func)log_dev_ptr->swo_log_func->print(ch);if(tmp_read >= LOG_MAX_LEN){log_dev_ptr->read_idx = 0;}else{log_dev_ptr->read_idx = tmp_read;}} }1 通過IDE輸出
使用IDE中SWO輸出功能需要做如下配置(Keil):
在窗口可以看到輸出的log:
2 通過STM32 ST-LINK Utility輸出
使用STM32 ST-LINK Utility不需要做特別的設置,直接打開ST-LINK菜單下的Printf via SWO viewer,然后按start:
通過串口輸出log
以上都是在串口log暫時無法使用,或者只是臨時用一下的方法,而適合長期使用的還是需要通過串口輸出log,畢竟大部分時候沒法連接仿真器。
添加串口輸出log只需要添加串口的操作函數集即可:
typedef struct {volatile u8 type;u8* buffer;volatile u32 write_idx;volatile u32 read_idx;volatile u32 dma_read_idx;//uartlog_func* uart_log_func;//SWOlog_func* swo_log_func; }log_dev;實現串口驅動函數:
log_func uart_log_func = {uart_log_init,uart_print_ch,0, };添加串口輸出log與通過SWO過程類似,不再多敘述。而下面要討論的問題是,串口的速率較低,輸出數據需要較長時間,嚴重影響系統運行。雖然可以通過先打印到SRAM再延時輸出的辦法來減輕影響,但是如果系統中斷頻繁,或者需要做耗時運算,則可能會丟失log。要解決這個問題,就是要解決CPU與輸出數據到串口同時進行的問題,嵌入式工程師立馬可以想到DMA正是好的解決途徑。
使用DMA搬運log數據到串口輸出,同時又不影響CPU運行,這樣就可以解決輸出串口log耗時影響系統的問題:STM32串口收發數據為什么要使用DMA?串口及DMA初始化函數如下:
u8 uart_log_init(void* arg) {DMA_InitTypeDef DMA_InitStructure;u32* bound = (u32*)arg;//GPIO端口設置GPIO_InitTypeDef GPIO_InitStructure;USART_InitTypeDef USART_InitStructure;RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA,ENABLE); //使能GPIOA時鐘RCC_APB1PeriphClockCmd(RCC_APB1Periph_USART2,ENABLE);//使能USART2時鐘//串口2對應引腳復用映射GPIO_PinAFConfig(GPIOA,GPIO_PinSource2,GPIO_AF_USART2);//USART2端口配置GPIO_InitStructure.GPIO_Pin = GPIO_Pin_2;GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF;//復用功能GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; //速度50MHzGPIO_InitStructure.GPIO_OType = GPIO_OType_PP; //推挽復用輸出GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP; //上拉GPIO_Init(GPIOA,&GPIO_InitStructure);//USART2初始化設置USART_InitStructure.USART_BaudRate = *bound;//波特率設置USART_InitStructure.USART_WordLength = USART_WordLength_8b;//字長為8位數據格式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); //初始化串口1 #ifdef LOG_UART_DMA_EN USART_DMACmd(USART2,USART_DMAReq_Tx,ENABLE); #endif USART_Cmd(USART2, ENABLE); //使能串口1 USART_ClearFlag(USART2, USART_FLAG_TC);while (USART_GetFlagStatus(USART2, USART_FLAG_TC) == RESET); #ifdef LOG_UART_DMA_ENRCC_AHB1PeriphClockCmd(RCC_AHB1Periph_DMA1, ENABLE);//Config DMA channel, uart2 TX usb DMA1 Stream6 ChannelDMA_DeInit(DMA1_Stream6);DMA_InitStructure.DMA_Channel = DMA_Channel_4;DMA_InitStructure.DMA_PeripheralBaseAddr = (uint32_t)(&USART2->DR);DMA_InitStructure.DMA_DIR = DMA_DIR_MemoryToPeripheral;DMA_InitStructure.DMA_PeripheralInc = DMA_PeripheralInc_Disable;DMA_InitStructure.DMA_MemoryInc = DMA_MemoryInc_Enable;DMA_InitStructure.DMA_PeripheralDataSize = DMA_PeripheralDataSize_Byte;DMA_InitStructure.DMA_MemoryDataSize = DMA_PeripheralDataSize_Byte;DMA_InitStructure.DMA_Mode = DMA_Mode_Normal;DMA_InitStructure.DMA_Priority = DMA_Priority_High;DMA_InitStructure.DMA_FIFOMode = DMA_FIFOMode_Disable; DMA_InitStructure.DMA_MemoryBurst = DMA_MemoryBurst_Single;DMA_InitStructure.DMA_PeripheralBurst = DMA_PeripheralBurst_Single;DMA_Init(DMA1_Stream6, &DMA_InitStructure);RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_DMA1, ENABLE); #endifreturn 0; }DMA輸出到串口的函數如下:
u8 uart_print_dma(u8* buffer, u32 len) {if((DMA1_Stream6->CR & DMA_SxCR_EN) != RESET){//dma not readyreturn 1;}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中斷方式,查Datasheet可以找到串口2使用DMA1 channel4的stream6:
最后在PC端串口助手可以看到log輸出:
使用DMA搬運log buffer中數據到串口,同時CPU可以處理其他事情,這種方式對系統影響最小,并且輸出log及時,是實際使用中用的最多的方式。并且不僅可以用串口,其他可以用DMA操作的接口(如SPI、USB)都可以使用這種方法來打印log。
使用IO模擬串口輸出log
最后要討論的是在一些封裝中沒有串口,或者串口已經被用作其他用途時如何輸出log,這時可以找一個空閑的普通IO,模擬UART協議輸出log到上位機的串口工具。
常用的UART協議如下:
只要在確定的時間在IO上輸出高低電平就可以模擬出波形,這個確定的時間就是串口波特率。
為了得到精確延時,這里使用TIM4定時器產生1us的延時。注意:定時器不能重復用,在測試工程中TIM2、3都被用了,如果重復用就錯亂了。
初始化函數如下:
u8 simu_log_init(void* arg) {TIM_TimeBaseInitTypeDef TIM_InitStructure; u32* bound = (u32*)arg;//GPIO端口設置GPIO_InitTypeDef GPIO_InitStructure;RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA,ENABLE); //使能GPIOA時鐘GPIO_InitStructure.GPIO_Pin = GPIO_Pin_2;GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; //速度50MHzGPIO_InitStructure.GPIO_OType = GPIO_OType_PP; //推挽復用輸出GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP; //上拉GPIO_Init(GPIOA,&GPIO_InitStructure);GPIO_SetBits(GPIOA, GPIO_Pin_2);//Config TIMRCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM4,ENABLE); //使能TIM4時鐘TIM_DeInit(TIM4);TIM_InitStructure.TIM_Prescaler = 1; //2分頻TIM_InitStructure.TIM_CounterMode = TIM_CounterMode_Up;TIM_InitStructure.TIM_Period = 41; //1us timerTIM_InitStructure.TIM_ClockDivision = TIM_CKD_DIV1;TIM_TimeBaseInit(TIM4, &TIM_InitStructure);TIM_ClearFlag(TIM4, TIM_FLAG_Update);baud_delay = 1000000/(*bound); //根據波特率計算每個bit延時return 0; }使用定時器的delay函數為:
void simu_delay(u32 us) {volatile u32 tmp_us = us;TIM_SetCounter(TIM4, 0);TIM_Cmd(TIM4, ENABLE);while(tmp_us--){while(TIM_GetFlagStatus(TIM4, TIM_FLAG_Update) == RESET);TIM_ClearFlag(TIM4, TIM_FLAG_Update);} TIM_Cmd(TIM4, DISABLE); }最后是模擬輸出函數,注意:輸出前必須要關閉中斷,一個byte輸出完再打開,否則會出現亂碼:
u8 simu_print_ch(u8 ch) {volatile u8 i=8;__asm("cpsid i");//start bitGPIO_ResetBits(GPIOA, GPIO_Pin_2);simu_delay(baud_delay);while(i--){if(ch & 0x01)GPIO_SetBits(GPIOA, GPIO_Pin_2);elseGPIO_ResetBits(GPIOA, GPIO_Pin_2);ch >>= 1;simu_delay(baud_delay);}//stop bitGPIO_SetBits(GPIOA, GPIO_Pin_2);simu_delay(baud_delay);simu_delay(baud_delay);__asm("cpsie i");return 0; }介紹了幾種開發中使用過的打印調試信息的方法,方法總是死的,關鍵在于能靈活使用;通過打印有效的調試信息,可以幫助解決開發及后期維護中遇到的問題,少走彎路。
如果是你在項目中,沒有串口線你會怎么調試呢?請在評論區說出你的想法。
總結
以上是生活随笔為你收集整理的没有串口,如何打印单片机调试信息?的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 基于matplotlib对iris数据集
- 下一篇: iOS手势密码开关