s3c6410的RTC在linux中的驱动（2）

armeasy

上一篇主要是关于s3c6410的RTC在linux中驱动实现的整体结构框图，只有明白整体结构，我们才能进行自己的特定平台的RTC设备的驱动开发。这一篇我们就深入分析RTC设备驱动的具体实现。
1、根据上一篇的分析，我们直接看Rtc-s3c.c (linux2.6.28\drivers\rtc)文件。首先注册一个平台设备，然后由平台设备负责完成RTC的驱动工作，看下面的源码：
static char __initdata banner[] = "S3C24XX RTC, (c) 2004,2006 Simtec Electronics\n";
static int __init s3c_rtc_init(void)
{
printk(banner);
return platform_driver_register(&s3c2410_rtc_driver);
}
static void __exit s3c_rtc_exit(void)
{
platform_driver_unregister(&s3c2410_rtc_driver);
}
module_init(s3c_rtc_init);
module_exit(s3c_rtc_exit);

先看s3c_rtc_init函数，这是RTC模块的加载函数，主要调用的是platform_driver_register(&s3c2410_rtc_driver)函数，这个函数大家应该都很熟悉了，很常见。对应的 platform_driver结构体如下：
static struct platform_driver s3c2410_rtc_driver = {
.probe  = s3c_rtc_probe,RTC的探测函数
.remove  = s3c_rtc_remove,移除函数
.suspend  = s3c_rtc_suspend,挂起函数
.resume  = s3c_rtc_resume,恢复函数
.driver  = { 内嵌的驱动结构体
.name = "s3c2410-rtc",
.owner  = THIS_MODULE,
},
};

对应的s3c_rtc_exit函数就不看了，主要调用platform_driver_unregister(&s3c2410_rtc_driver)函数。
2、老生常谈的话题——probe()函数
内核在启动时，会注册平台设备和平台设备和驱动程序。内核在适当的时机，将这两者联系起来，进行设备和驱动的匹配。匹配成功后，就会调用probe函数，这里就是s3c_rtc_probe函数。源码如下：
static int s3c_rtc_probe(struct platform_device *pdev)
{
struct rtc_device *rtc;
struct resource *res;
int ret;
unsigned char bcd_tmp,bcd_loop;


pr_debug("%s: probe=%p\n", __func__, pdev);

在Devs.c (linux2.6.28\arch\arm\plat-s3c64xx)文件中有如下定义：
static struct resource s3c_rtc_resource[] = {
[0] = {
.start = S3C_PA_RTC,
.end   = S3C_PA_RTC + 0xff,
.flags = IORESOURCE_MEM,
},
[1] = {
.start = IRQ_RTC_ALARM,
.end   = IRQ_RTC_ALARM,
.flags = IORESOURCE_IRQ,
},
[2] = {
.start = IRQ_RTC_TIC,
.end   = IRQ_RTC_TIC,
.flags = IORESOURCE_IRQ
}
};
struct platform_device s3c_device_rtc = {
.name  = "s3c2410-rtc",
.id  = -1,
.num_resources = ARRAY_SIZE(s3c_rtc_resource),
.resource   = s3c_rtc_resource,
};


EXPORT_SYMBOL(s3c_device_rtc);
/* find the IRQs */这里涉及到平台设备的资源，看上面的结构体。
s3c_rtc_tickno = platform_get_irq(pdev, 1);读取平台设备的资源结构体s3c_rtc_resource中的第二个中断号，即TICK中断
if (s3c_rtc_tickno < 0) {
dev_err(&pdev->dev, "no irq for rtc tick\n");
return -ENOENT;
}
s3c_rtc_alarmno = platform_get_irq(pdev, 0);读取平台设备的资源结构体s3c_rtc_resource中的第一个中断号，即ALARM中断
if (s3c_rtc_alarmno < 0) {
dev_err(&pdev->dev, "no irq for alarm\n");
return -ENOENT;
}

printk("s3c2410_rtc: tick irq %d, alarm irq %d\n",
s3c_rtc_tickno, s3c_rtc_alarmno);

/* get the memory region */先获得RTC和I/O资源，再进行映射，返回虚拟地址
res = platform_get_resource(pdev, IORESOURCE_MEM, 0);//struct resource *res;
if (res == NULL) {
dev_err(&pdev->dev, "failed to get memory region resource\n");
return -ENOENT;
}
s3c_rtc_mem = request_mem_region(res->start,
res->end-res->start+1,
pdev->name);
if (s3c_rtc_mem == NULL) {
dev_err(&pdev->dev, "failed to reserve memory region\n");
ret = -ENOENT;
goto err_nores;
}
s3c_rtc_base = ioremap(res->start, res->end - res->start + 1);
if (s3c_rtc_base == NULL) {
dev_err(&pdev->dev, "failed ioremap()\n");
ret = -EINVAL;
goto err_nomap;
}


/* check to see if everything is setup correctly */
s3c_rtc_enable(pdev, 1);        该函数用来设置RTC的工作状态，开始和停止。第一个参数是     struct platform_device 指针，第二个参数是使能标志en.en为0，表示停止工作；en不为0，则表示开始工作。打开RTC实时时钟。这个函数的定义在Rtc-s3c.c (linux2.6.28\drivers\rtc)文件中，源码如下：
static void s3c_rtc_enable(struct platform_device *pdev, int en)
{
void __iomem *base = s3c_rtc_base;
if (s3c_rtc_base == NULL)
return;
s3c_rtc_enable_set(pdev,base,en);
}
继续看
voids3c_rtc_enable_set(struct platform_device *pdev,void __iomem *base, int en)
{
unsigned int tmp;
if (!en) {    en等于0时执行，表示关闭RTC。
tmp = readw(base + S3C2410_RTCCON);有如下定义：
#define S3C2410_RTCCON      S3C2410_RTCREG(0x40)

#define S3C2410_RTCREG(x) (x)

所以表示读取下面的寄存器，有人可能有疑问？
看下这个是在平台设备中定义的基地址，应该明白了吧!
#define S3C_PA_RTC S3C64XX_PA_RTC
#define S3C64XX_PA_RTC   (0x7E005000)




          writew(tmp & ~ (S3C2410_RTCCON_RTCEN | S3C_RTCCON_TICEN), base + S3C2410_RTCCON);
写这个寄存器的某些位。看下面，可知把第0位和第8位清零，这两位的含义看下图：
#define S3C2410_RTCCON_RTCEN  (1<<0)

#define S3C_RTCCON_TICEN      (1<<8)






} else {   en为1是执行。表示开启RTC，就不具体讲了主要是先读出寄存器值进行判断，然后如果有需要在从读并回写。对这芯片手册，很简单。
/* re-enable the device, and check it is ok */
if ((readw(base+S3C2410_RTCCON) & S3C2410_RTCCON_RTCEN) == 0){
dev_info(&pdev->dev, "rtc disabled, re-enabling\n");

tmp = readw(base + S3C2410_RTCCON);
writew(tmp|S3C2410_RTCCON_RTCEN, base+S3C2410_RTCCON);
}

if ((readw(base + S3C2410_RTCCON) & S3C2410_RTCCON_CNTSEL)){
dev_info(&pdev->dev, "removing RTCCON_CNTSEL\n");

tmp = readw(base + S3C2410_RTCCON);
writew(tmp& ~S3C2410_RTCCON_CNTSEL, base+S3C2410_RTCCON);
}

if ((readw(base + S3C2410_RTCCON) & S3C2410_RTCCON_CLKRST)){
dev_info(&pdev->dev, "removing RTCCON_CLKRST\n");
tmp = readw(base + S3C2410_RTCCON);
writew(tmp & ~S3C2410_RTCCON_CLKRST, base+S3C2410_RTCCON);
}
}
}
说完了这个函数就可以回到s3c_rtc_probe函数接着说了，下篇再聊。
pr_debug("s3c2410_rtc: RTCCON=%02x\n",
readb(s3c_rtc_base + S3C2410_RTCCON));


s3c_rtc_setfreq(&pdev->dev, 1);


device_init_wakeup(&pdev->dev, 1);


/* register RTC and exit */


rtc = rtc_device_register("s3c", &pdev->dev, &s3c_rtcops,
THIS_MODULE);


if (IS_ERR(rtc)) {
dev_err(&pdev->dev, "cannot attach rtc\n");
ret = PTR_ERR(rtc);
goto err_nortc;
}


rtc->max_user_freq = S3C_MAX_CNT;


/* check rtc time */
for (bcd_loop = S3C2410_RTCSEC ; bcd_loop <= S3C2410_RTCYEAR ; bcd_loop +=0x4)
{
bcd_tmp = readb(s3c_rtc_base + bcd_loop);
if(((bcd_tmp & 0xf) > 0x9) || ((bcd_tmp & 0xf0) > 0x90))
writeb(0, s3c_rtc_base + bcd_loop);
}


platform_set_drvdata(pdev, rtc);


return 0;


err_nortc:
s3c_rtc_enable(pdev, 0);
iounmap(s3c_rtc_base);


err_nomap:
release_resource(s3c_rtc_mem);


err_nores:
return ret;
}