一起学mini2440裸机开发(七)--UART高级实验，可变参函数
概述：
在C语言中，使用printf()进行格式化输出非常方便，例如，printf("%d\n",a)可以将a的值以十进制的格式输出，然后换行。printff()函数的原型为：int printf(const char *format,...)，在函数参数中的...表示可变参数，即输入参数的个数不确定（例如，printf("%d\n",a)和printf("%d%d\n",a,b)都可以使函数进行正确的输出），这种输入参数不确定的函数就叫可变参数。在UART中能不能自己写一个类似于 printf() 的函数（例如，Uart0_Printf("%d",a)）呢？下面咱们就试图找到实现这种函数的方法。
实验内容:
本实验要实现的功能就是利用uart实现发送可变参数的功能。
实验代码结构如下图：
实验一共包含3个文件：main.c uart.c uart.h
main.c文件内容：
#include<s3c2440.h>
#include"uart.h"int main()
{
unsigned int a=10; //系统时钟初始化，FCLK=400MHz,HCLK=100MHz,PCLK=50MHz
Uart0_Init(115200); //初始化并设置波特率为115 200
while(1)
{
Uart0_Printf("Uart0_Printf test output is:%d\n",a);
}
}
uart.c文件内容：
#include<s3c2440.h>
#include<stdarg.h>
#include"uart.h"#define PCLK 50000000
#define UART_BRD (int)((PCLK/(baudrate*16))-1)/***********************************************
*函数名称：void Uart0_Init(unsigned int baudrate)
*参数说明：baudrate：波特率
*返 回 值：无
*全局变量: 无
*功 能：对UART0进行初始化
************************************************/
void Uart0_Init(unsigned int baudrate)
{
GPHCON&=~((3<<4)|(3<<6)); //GPH2--TXD0;GPH3--RXD0
GPHCON|=((2<<4)|(2<<6)); //设置GPH2、GPH3为TXD0、RXD0功能
GPHUP=0x00; //上拉电阻使能
ULCON0|=0x03; //设置数据发送格式：8个数据位，1个停止位，无校验位
UCON0=0x05; //发送模式和接收模式都使用查询模式
UBRDIV0=UART_BRD; //设置波特率，其中波特率作为一个参数传递到该初始化函数
URXH0=0; //将URXH0清零
}/***********************************************
*函数名称：void putc(unsigned char c)
*参数说明：c:通过串口接收到的字符，注意这里是8位数据
*返 回 值：无
*全局变量: 无
*功 能：将通过串口接收到的字符发送给PC机并显示在
* 串口调试工具。
************************************************/
void putc(unsigned char c)
{
UTXH0=c;
while(!(UTRSTAT0&(1<<2))); //等待发送完成
}/***********************************************
*函数名称：unsigned char getc(void)
*参数说明：无
*返 回 值：c:通过串口接收到的字符，注意这里是8位数据
*全局变量: 无
*功 能：接收并保存通过串口输入的数据
************************************************/
unsigned char getc(void)
{
unsigned char c;
while(!(UTRSTAT0&(1<<0))); //查询是否接收到有效数据
c=URXH0;
return c;
}
/***********************************************
*函数名称：static void Uart0_SendByte(int data)
*参数说明：data:一个字节的数据
*返 回 值：无
*全局变量: 无
*功 能：向串口发送一个字节的数据。这个函数只在本
* C文件内使用，不被其他文件所调用，故使用
* static来修饰。
************************************************/static void Uart0_SendByte(int data)
{
if(data=='\n') //注意，在超级终端中使用的换行符是'\r'，因此当遇到'\n'时
{ //需要将其转换为'r'
while(!(UTRSTAT0&(1<<2))); //等待发送完成
UTXH0='\r';
}
while(!(UTRSTAT0&(1<<2))); //等待发送完成完成后，将新发送
UTXH0=data; //的数据写入发送寄存器
}
/***********************************************
*函数名称：static void Uart0_SendString(char *pt)
*参数说明：pt:指针，指向将要发送的数据所在数组的地址
*返 回 值：无
*全局变量: 无
*功 能：发送字符串
************************************************/
static void Uart0_SendString(char *pt)
{
while(*pt)
{
Uart0_SendByte(*pt++);
}
}
/***********************************************
*函数名称：void Uart0_Printf(const char *fmt,...)
*参数说明：可变参数
*返 回 值：无
*全局变量: 无
*功 能：将()的内容通过串口发送并在PC机显示
************************************************/
void Uart0_Printf(const char *fmt,...)
{
va_list ap; //定义了一个指向可变参数列表指针
char string[50]; //存储要发送的内容va_start(ap,fmt); //是参数列表指针ap指向函数参数列表中的第一个可变参数
vsprintf(string,fmt,ap);
va_end(ap); //清空参数列表
Uart0_SendString(string); //将该缓冲区中的数据打印到串口中
}
下面重点讲解一下Uart0_Printf(const char *fmt,...)
void Uart0_Printf(const char *fmt,...)
{
va_list ap; //定义了一个指向可变参数列表指针
char string[50]; //存储要发送的内容
va_start(ap,fmt); //是参数列表指针ap指向函数参数列表中的第一个可变参数
vsprintf(string,fmt,ap);
va_end(ap); //清空参数列表
Uart0_SendString(string); //将该缓冲区中的数据打印到串口中
}
理解这个函数需要了解下面的基础知识：
可变参数的列表分为两部分：固定参数和个数可变的可变参数。函数中至少有一个固定参数；可变参数由于个数不确定，声明用"..."表示。
● va_list ap：定义了一个指向可变参数列表指针。
● va_start(ap,argN)：使参数列表指针ap指向函数列表中的第一个可变参数，argN是最后一个固定参数。例如，当函数的声明是void va_test(char a,char b,...)，则它的固定参数依次是a，b，最后一个固定参数argN为c，因此就是a_start(ap,c)。
● va_end(ap)：清空参数列表，并置参数指针ap无效，该宏的作用是结束可变参数的获取。
● vsprintf()函数原型为int vsprintf(char *string,char *format,va_list param)，其作用是将param按格式format写入字符串string中。
因此，上述函数的基本流程是：
● 先开辟一块区域存储可变参数
● 然后，调用vsprintf()函数将可变参数按照指定的格式复制到缓冲区中。
● 最后，调用Uart0_SendString()函数将该缓冲区中的数据打印到串口中。
将以上3个文件，复制完后，再编译调试后，可以看到串口的效果：
我将该工程文档上传到：可自行下载点击打开链接
注意：老生长谈
①将S3C2440.s中的CLOCK_SETUP EQU 0 修改为 CLOCK_SETUP EQU 1
②复制并修改Ext_RAM文件。