WinCE中RTC驱动开发介绍

作者：ARM-WINCE

快到春节了，稍微轻松点了。刚刚在WinCE6.0下开发了RTC的驱动，在这里介绍一下。

RTC就是实时时钟(real time clock)。目前大部分32bit处理器都自带RTC模块，也有外接RTC模块的。一般外接的RTC都是通过I2C总线来访问。如果CPU本身自带RTC，那通过读取内部寄存器就能访问RTC模块。如果是外接的，就要麻烦一点，还要写个I2C的驱动来访问外部RTC模块。

在WinCE6.0里面，RTC的驱动是在OAL里面实现的，文件名一般都叫rtc.c。在这个文件里面有3个重要的函数，只要实现了他们，RTC的驱动就完成了，函数如下：

BOOL OEMGetRealTime(LPSYSTEMTIME lpst) ： 获得当前的时间

BOOL OEMSetRealTime(LPSYSTEMTIME lpst)： 设置当前的时间

BOOL OEMSetAlarmTime(LPSYSTEMTIME lpst)： 设置报警的时间

上面三个函数的参数都是lpst，这里介绍一下：

LPSYSTEMTIME实际上是一个指向SYSTEMTIME结构的指针，关于SYSTEMTIME，定义如下：

typedef struct _SYSTEMTIME {
WORD wYear;
WORD wMonth;
WORD wDayOfWeek;
WORD wDay;
WORD wHour;
WORD wMinute;
WORD wSecond;
WORD wMilliseconds;
} SYSTEMTIME;

明白了吧，呵呵。

OEMGetRealTime(..)用来获得当前的时间。WinCE启动以后，默认情况下，WinCE会每隔一段时间调用OEMGetRealTime(..)函数来获得系统的时间，这种方式被称为hardware mode。WinCE还有另一种获得系统时间的方法，被称为software mode，就是通过调用GetTickCount(..)函数跟踪系统的timetick的变化来累加时间。如果要用software mode，那么需要在注册表中做如下的设置：

HKEY_LOCAL_MACHINE\Platform\"SoftRTC" = 1

我来谈谈我的看法，一般都要使用hardware mode，这样获得的系统时间比较准。software mode获得系统时间不会很准的。

OEMSetRealTime(..)用来设置当前的时间。当WinCE启动以后，我们会在界面的右下角看到时间显示，我们可以直接在WinCE的界面里面设置时间，这个时候，系统就会调用OEMSetRealTime(..)把你设置的时间写到RTC模块里面。这里要提一下，我们都知道在OEMIoControl函数里面有一个case叫IOCTL_HAL_INIT_RTC，这个case用来在初始化的时候设置实时时钟的初始值，一般在这个case里面会调用OEMSetRealTime(..)函数。参考代码如下：

case IOCTL_HAL_INIT_RTC:
// The kernel has detected a cold boot.
// The real-time clock probably needs to be reset.
if( nInBufSize >= sizeof(SYSTEMTIME) )
return OEMSetRealTime( (LPSYSTEMTIME)lpInBuf );
else
return FALSE;
break;

OEMSetAlarmTime(..)用来设置报警时间。实现这个函数，要看你的RTC模块是否具有报警功能。具备报警功能的RTC会允许你设置报警时间，当你设置了报警时间以后，RTC会比较你的报警时间和当前时间，一旦这两个时间相等了，就会产生中断。大致原理就是这样了。所以这个函数里面实际上就是实现设置一个报警时间，还有就是打开相应的RTC中断。当然在中断程序ISR中，要返回SYSINTR_RTC_ALARM。在应用程序中，我们可以通过调用CeRunAppAtTime(..)来在一个指定的时间运行一个应用程序。这个函数好像会调用OEMSetAlarmTime(..)来设置报警时间。具体没有试过。

大致就是这些内容，一般在WinCE5.0和WinCE6.0中，RTC没有太大变化。唯一的不同就是在WinCE6.0中，这三个函数都需要添加临界区的保护，以前在WinCE5.0中没有看到过。 说了这么多，来举个例子，下面的代码基于实时时钟芯片ISL1208做的，仅供参考：

#define AL_ENABLE 0x80

CRITICAL_SECTION RTC_critsect;
static unsigned char critical_flag = 1;

void I2C_Init(void);
void ISL1208_Init(void);
DWORD I2C_Write(unsigned char slaveaddr, unsigned char regaddr, unsigned char* buf, DWORD num);
DOWRD I2C_Read(unsigned char slaveaddr, unsigned char regaddr, unsigned char* buf, DWORD num);

BOOL OEMGetRealTime(LPSYSTEMTIME lpst)
{
unsigned char buf[12];
DWORD flg;

//RETAILMSG(1, (_T(":::::OEMGetRealTime:::::\r\n")));
if (critical_flag) // 第一次上电
{
InitializeCriticalSection(&RTC_critsect); //初始化临界区
I2C_Init(); //初始化
I2C ISL1208_Init(); //初始化ISL1208实时时钟芯片。
critical_flag = 0;
}

EnterCriticalSection(&RTC_critsect);

memset(buf, 0, sizeof(buf));
flg = I2C_Read(ISL1208, 0x0, buf, 6); //读取ISL1208的时间
if (!flg) //I2C失败，返回错误
{
RETAILMSG(1, (_T("::::::: OEMGetRealTime Error...\r\n")));
return FALSE;
}

LeaveCriticalSection(&RTC_critsect);

buf[2] &= 0x7f; //清除MIL位
lpst->wSecond = (WORD)((buf[0] & 0x0f) + (buf[0] >> 4) * 10); // 获得当前时间，并将时间从BCD码转换为十进制
lpst->wMinute = (WORD)((buf[1] & 0x0f) + (buf[1] >> 4) * 10);
lpst->wHour = (WORD)((buf[2] & 0x0f) + (buf[2] >> 4) * 10);
lpst->wDay = (WORD)((buf[3] & 0x0f) + (buf[3] >> 4) * 10);
lpst->wMonth = (WORD)((buf[4] & 0x0f) + (buf[4] >> 4) * 10);
lpst->wYear = (WORD)buf[5] + 2000;

return TRUE;
}

BOOL OEMSetRealTime(LPSYSTEMTIME lpst)
{
unsigned char buf[12];
WORD year;
DWORD flg;

//RETAILMSG(1, (_T(":::::OEMSetRealTime:::::\r\n")));

EnterCriticalSection(&RTC_critsect);

if (lpst->wYear > 2000)
{
year = lpst->wYear - 2000;
}
else
{
year = 0;
}
buf[0] = (((lpst->wSecond) / 10) << 4) | ((lpst->wSecond) % 10); //设置时间，十进制转换成BCD码
buf[1] = (((lpst->wMinute) / 10) << 4) | ((lpst->wMinute) % 10);
buf[2] = (((lpst->wHour) / 10) << 4) | ((lpst->wHour) % 10);
buf[3] = (((lpst->wDay) / 10) << 4) | ((lpst->wDay) % 10);
buf[4] = (((lpst->wMonth) / 10) << 4) | ((lpst->wMonth) % 10);
buf[5] = ((year / 10) << 4) | (year % 10);
buf[6] = (unsigned char)lpst->wDayOfWeek;
buf[2] |= 0x80; // Set MIL bit equal 1
flg = I2C_Write(ISL1208, 0x0, buf, 7);
if (!flg)
{
RETAILMSG(1, (_T("::::::: OEMSetRealTime Error...\r\n")));
return FALSE;
}

LeaveCriticalSection(&RTC_critsect);

return TRUE;
}

BOOL OEMSetAlarmTime(LPSYSTEMTIME lpst)
{
unsigned char buf[12];
DWORD flg;

//RETAILMSG(1, (_T(":::::OEMSetAlarmTime:::::\r\n")));

EnterCriticalSection(&RTC_critsect);

memset(buf, 0, sizeof(buf));
buf[1] = (((lpst->wSecond) / 10) << 4) | ((lpst->wSecond) % 10) | AL_ENABLE; //设置报警寄存器
buf[2] = (((lpst->wMinute) / 10) << 4) | ((lpst->wMinute) % 10) | AL_ENABLE;
buf[3] = (((lpst->wHour) / 10) << 4) | ((lpst->wHour) % 10) | AL_ENABLE;
buf[4] = (((lpst->wDay) / 10) << 4) | ((lpst->wDay) % 10) | AL_ENABLE;
buf[5] = (((lpst->wMonth) / 10) << 4) | ((lpst->wMonth) % 10) | AL_ENABLE;
flg = I2C_Write(ISL1208, 0xC, buf, 6);
if (!flg)
{
RETAILMSG(1, (_T("::::::: OEMSetRealTime Error...\r\n")));
return FALSE;
}
flg = *VIC2_INTENABLE; //使能外部中断1，因为RTC的中断输出接在了处理器的外部中断1上面
flg |= INT2_EXT1;
*VIC2_INTENABLE = flg;

LeaveCriticalSection(&RTC_critsect);

// return TRUE if alarm set, FALSE otherwise
return TRUE;
}

DWORD ISL1208_Init(void)
{
DWORD flg;
unsigned char buf[12];

memset(buf, 0, sizeof(buf));
flg = I2C_Read(ISL1208, 0x0, buf, 6);
if (!flg)
{
RETAILMSG(1, (_T("::::::: ISL1208_Init Error...\r\n")));
return FALSE;
}

if ((buf[0] != 0) || (buf[1] != 0) || (buf[2] != 0) || (buf[3] != 0) || (buf[4] != 0) || (buf[5] != 0))
{//时间被设置过，证明ISL1208被初始化过，直接返回
return TRUE;
}

buf[0] = STATUS_WRTC |STATUS_ARST;
flg = I2C_Write(ISL1208, 0x7, buf, 1, 0); // 设置ISL1208状态控制寄存器
DelayInMsec(1);

buf[0] = INT_ALME | 0x80; // 使能ISL1208报警功能，中断输出，单次触发
flg = I2C_Write(ISL1208, 0x8, buf, 1, 0); if (!flg)
{
RETAILMSG(1, (_T("::::::: OEMSetRealTime Error...\r\n")));
return FALSE;
}

buf[0] = DEFAULT_SECOND | AL_ENABLE; // 设置报警寄存器，设置报警时间，这里设置了个默认值
buf[1] = DEFAULT_MINUTE | AL_ENABLE; //
buf[2] = DEFAULT_HOUR | AL_ENABLE;
buf[3] = DEFAULT_DATE | AL_ENABLE;
buf[4] = (DEFAULT_MONTH + 1) | AL_ENABLE;
flg = I2C_Write(ISL1208, 0xC, buf, 5, 0);
if (!flg)
{
RETAILMSG(1, (_T("::::::: I2C Write Error...\r\n")));
return 0;
}

buf[0] = DEFAULT_SECOND; //设置系统时间，这里设置了个默认时间
buf[1] = DEFAULT_MINUTE;
buf[2] = DEFAULT_HOUR;
buf[3] = DEFAULT_DATE;
buf[4] = DEFAULT_MONTH;
buf[5] = DEFAULT_YEAR;
buf[6] = DEFAULT_WEEK;
flg = I2C_Write(ISL1208, 0x0, buf, 7, 0); if (!flg)
{
RETAILMSG(1, (_T("::::::: I2C Write Error...\r\n")));
return 0;
}

return 1;
}