WinCE中RTC驱动开发介绍

快到春节了，稍微轻松点了。刚刚在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;
}