printf实现

详解U-Boot中printf函数的实现

一、printf函数调用关系

1.1fputc和srial_putc的关系

[plain] view plain copy

 print?

1. /*  
2.  * Output a single byte to the serial port.  
3.  */  
4. void serial_putc (const char c)//发送数据  
5. {  
6.     S3C24X0_UART * const uart = S3C24X0_GetBase_UART(UART_NR);  
7. #ifdef CONFIG_MODEM_SUPPORT  
8.     if (be_quiet)  
9.         return;  
10. #endif  
11.   
12.     /* wait for room in the tx FIFO */  
13.     while (!(uart->UTRSTAT & 0x2));  
14.   
15. #ifdef CONFIG_HWFLOW  
16.     /* Wait for CTS up */  
17.     while(hwflow && !(uart->UMSTAT & 0x1))  
18.         ;  
19. #endif  
20.   
21.     uart->UTXH = c;  
22.   
23.     /* If \n, also do \r */  
24.     if (c == '\n')  
25.         serial_putc ('\r');  
26. }  

serial_putc函数是直接和控制相关的，通过UTXH寄存器发送数据。

[plain] view plain copy

 print?

1. void fputc (int file, const char c)  
2. {  
3.     if (file < MAX_FILES)  
4.         stdio_devices[file]->putc (c);  
5. }  

这是在console_init_r中设置stdio_devices[]后才有的，其他的是类似的。

1.2putc和fputc的关系

[plain] view plain copy

 print?

1. void putc (const char c)  
2. {  
3. #ifdef CONFIG_SILENT_CONSOLE  
4.     if (gd->flags & GD_FLG_SILENT)  
5.         return;  
6. #endif  
7.   
8.     if (gd->flags & GD_FLG_DEVINIT) {  
9.         /* Send to the standard output */  
10.         fputc (stdout, c);  
11.     } else {  
12.         /* Send directly to the handler */  
13.         serial_putc (c);  
14.     }  
15. }  

这是console_init_r中设置gd->flags & GD_FLG_DEVINIT，也就是串口设备完全初始化之后才有这种关系，其他的函数是类似的。

二、serial_printf (const char *fmt, ...)

serial_printf函数是通过一个宏va_start把所有的可变参数放到了由args指向的一块内存中，vsprintf将变参列表args中的变量按照fmt中规定的格式保存到临时缓冲printbuffer中，最后调用serial_puts函数将临时缓冲中的字符串数据打印到终端中去。

[plain] view plain copy

 print?

1. void serial_printf (const char *fmt, ...)  
2. {  
3.     va_list args;  
4.     uint i;  
5.     char printbuffer[CFG_PBSIZE];  
6.   
7.     va_start (args, fmt);  
8.   
9.     /* For this to work, printbuffer must be larger than  
10.      * anything we ever want to print.  
11.      */  
12.     i = vsprintf (printbuffer, fmt, args);  
13.     va_end (args);  
14.   
15.     serial_puts (printbuffer);  
16. }  

三、fprintf(int file, const char *fmt, ...)

fprintf函数是通过一个宏va_start把所有的可变参数放到了由args指向的一块内存中，vsprintf将变参列表args中的变量按照fmt中规定的格式保存到临时缓冲printbuffer中，最后调用fputs函数将临时缓冲中的字符串数据打印到终端中去。

[plain] view plain copy

 print?

1. void fprintf (int file, const char *fmt, ...)  
2. {  
3.     va_list args;  
4.     uint i;  
5.     char printbuffer[CFG_PBSIZE];  
6.   
7.     va_start (args, fmt);  
8.   
9.     /* For this to work, printbuffer must be larger than  
10.      * anything we ever want to print.  
11.      */  
12.     i = vsprintf (printbuffer, fmt, args);  
13.     va_end (args);  
14.   
15.     /* Send to desired file */  
16.     fputs (file, printbuffer);  
17. }  

四、vprintf(const char *fmt, va_list args)

vprintf函数是通过一个宏va_start把所有的可变参数放到了由args指向的一块内存中，vsprintf将变参列表args中的变量按照fmt中规定的格式保存到临时缓冲printbuffer中，最后调用puts函数将临时缓冲中的字符串数据打印到终端中去。

[plain] view plain copy

 print?

1. void vprintf (const char *fmt, va_list args)  
2. {  
3.     uint i;  
4.     char printbuffer[CFG_PBSIZE];  
5.   
6.     /* For this to work, printbuffer must be larger than  
7.      * anything we ever want to print.  
8.      */  
9.     i = vsprintf (printbuffer, fmt, args);  
10.   
11.     /* Print the string */  
12.     puts (printbuffer);  
13. }  

五、printf(const char *fmt, ...)

printf函数是通过一个宏va_start把所有的可变参数放到了由args指向的一块内存中，vsprintf将变参列表args中的变量按照fmt中规定的格式保存到临时缓冲printbuffer中，最后调用puts函数将临时缓冲中的字符串数据打印到终端中去。

[plain] view plain copy

 print?

1. void printf (const char *fmt, ...)  
2. {  
3.     va_list args;  
4.     uint i;  
5.     char printbuffer[CFG_PBSIZE];  
6.   
7.     va_start (args, fmt);  
8.   
9.     /* For this to work, printbuffer must be larger than  
10.      * anything we ever want to print.  
11.      */  
12.     i = vsprintf (printbuffer, fmt, args);  
13.     va_end (args);  
14.   
15.     /* Print the string */  
16.     puts (printbuffer);  
17. }  

六、小结

serial_printf、vprintf和pringf函数基本相同，都是通过一个宏va_start把所有的可变参数放到了由args指向的一块内存中，vsprintf将变参列表args中的变量按照fmt中规定的格式保存到临时缓冲printbuffer中，最后调用不同的串口输出函数将临时缓冲中的字符串数据打印到终端中去。下面我们就来分析一下va_start、va_eng和vsprintf。