深入解析linux下rtc架构

转载来自: 深入解析linux下rtc架构 | 学步园 +http://www.xuebuyuan.com/1722840.html

一.描述rtc相关结构体

1.rtc设备

struct rtc_device	//rtc设备
{
struct device dev;					//设备文件
struct module *owner;				//所有者
int id;								//次设备号
char name[RTC_DEVICE_NAME_SIZE];	//rtc设备名
const struct rtc_class_ops *ops;	//rtc类操作函数集
struct mutex ops_lock;
struct cdev char_dev;				//字符设备
unsigned long flags;				//忙标志 (RTC_DEV_BUSY)
unsigned long irq_data;				//中断数据
spinlock_t irq_lock;
wait_queue_head_t irq_queue;
struct fasync_struct *async_queue;
struct rtc_task *irq_task;			//中断任务
spinlock_t irq_task_lock;
int irq_freq;						//中断频率
int max_user_freq;					//默认64
};

1.1 同时也定义了一个宏,通过设备文件查找rtc设备

#define to_rtc_device(d) container_of(d, struct rtc_device, dev)

2.rtc类操作函数集

struct rtc_class_ops {
int (*open)(struct device *);										//打开
void (*release)(struct device *);									//释放
int (*ioctl)(struct device *, unsigned int, unsigned long);			//控制
int (*read_time)(struct device *, struct rtc_time *);				//读时间
int (*set_time)(struct device *, struct rtc_time *);				//设置时间
int (*read_alarm)(struct device *, struct rtc_wkalrm *);			//读闹钟
int (*set_alarm)(struct device *, struct rtc_wkalrm *);				//设闹钟
int (*proc)(struct device *, struct seq_file *);					//proc接口
int (*set_mmss)(struct device *, unsigned long secs);				//设置时间mmss
int (*irq_set_state)(struct device *, int enabled);					//设置中断状态
int (*irq_set_freq)(struct device *, int freq);						//设置中断频率
int (*read_callback)(struct device *, int data);					//读回调函数
int (*alarm_irq_enable)(struct device *, unsigned int enabled);		//闹钟中断使能
int (*update_irq_enable)(struct device *, unsigned int enabled);	//更新中断使能
};

这里有两种设置时间的方法set_time和set_mmss,看它们参数可以区别出set_time使用rtc时间来设置,

set_mmss是根据秒数来设置(“Gregorian”时间)

二.rtc架构

1.rtc设备初始化函数

void __init rtc_dev_init(void)	//入口函数
{
int err;
err = alloc_chrdev_region(&rtc_devt, 0, RTC_DEV_MAX, "rtc");	//动态分配rtc设备号 RTC_DEV_MAX=16个
if (err < 0)
printk(KERN_ERR "%s: failed to allocate char dev region\n",__FILE__);
}

2.rtc设备的注册

rtc注册由具体设备驱动调用,同时设备驱动必须提供rtc_class_ops操作函数集

struct rtc_device *rtc_device_register(const char *name, struct device *dev,const struct rtc_class_ops *ops,struct module *owner)
{
struct rtc_device *rtc;	//rtc设备
int id, err;
if (idr_pre_get(&rtc_idr, GFP_KERNEL) == 0) {	//idr机制预分配
err = -ENOMEM;
goto exit;
}
mutex_lock(&idr_lock);
err = idr_get_new(&rtc_idr, NULL, &id);	//通过idr机制获取id号
mutex_unlock(&idr_lock);
if (err < 0)
goto exit;
id = id & MAX_ID_MASK;	//id掩码过滤
rtc = kzalloc(sizeof(struct rtc_device), GFP_KERNEL);	//分配rtc设备
if (rtc == NULL) {
err = -ENOMEM;
goto exit_idr;
}
rtc->id = id;				//次设备号
rtc->ops = ops;				//rtc类操作函数集
rtc->owner = owner;			//所有者
rtc->max_user_freq = 64;	//最大用户频率
rtc->dev.parent = dev;		//设备父设备
rtc->dev.class = rtc_class;	//2.1 设备类
rtc->dev.release = rtc_device_release;	//设备释放方法
mutex_init(&rtc->ops_lock);
spin_lock_init(&rtc->irq_lock);
spin_lock_init(&rtc->irq_task_lock);
init_waitqueue_head(&rtc->irq_queue);
strlcpy(rtc->name, name, RTC_DEVICE_NAME_SIZE);	//设置rtc设备名
dev_set_name(&rtc->dev, "rtc%d", id);			//设置设备名
rtc_dev_prepare(rtc);							//2.2 rtc设备准备
err = device_register(&rtc->dev);				//注册设备文件
if (err) {
put_device(&rtc->dev);
goto exit_kfree;
}
rtc_dev_add_device(rtc);	//2.3 rtc添加设备
rtc_sysfs_add_device(rtc);	//sysfs添加设备文件
rtc_proc_add_device(rtc);	//procfs添加设备文件
dev_info(dev, "rtc core: registered %s as %s\n",rtc->name, dev_name(&rtc->dev));
return rtc;
exit_kfree:
kfree(rtc);
exit_idr:
mutex_lock(&idr_lock);
idr_remove(&rtc_idr, id);
mutex_unlock(&idr_lock);
exit:
dev_err(dev, "rtc core: unable to register %s, err = %d\n",name, err);
return ERR_PTR(err);
}
EXPORT_SYMBOL_GPL(rtc_device_register);

2.1 设备类rtc_class

subsys_initcall(rtc_init);	//rtc子系统初始化

设备类初始化

static int __init rtc_init(void)
{
rtc_class = class_create(THIS_MODULE, "rtc");	//创建设备类“/sys/class/rtc”
if (IS_ERR(rtc_class)) {
printk(KERN_ERR "%s: couldn't create class\n", __FILE__);
return PTR_ERR(rtc_class);
}
rtc_class->suspend = rtc_suspend;	//挂起
rtc_class->resume = rtc_resume;		//唤醒
rtc_dev_init();	//这里发现 rtc设备初始化函数是在这里调用
rtc_sysfs_init(rtc_class);	//sysfs接口
return 0;
}

rtc子系统初始化:rtc类初始化->rtc设备初始化->注册rtc设备

2.2 rtc设备准备

void rtc_dev_prepare(struct rtc_device *rtc)
{
if (!rtc_devt)	//主设备号是否分配
return;
if (rtc->id >= RTC_DEV_MAX) {	//判断次设备号是否>16,最多支持16个RTC
pr_debug("%s: too many RTC devices\n", rtc->name);
return;
}
rtc->dev.devt = MKDEV(MAJOR(rtc_devt), rtc->id);	//设置rtc设备号
cdev_init(&rtc->char_dev, &rtc_dev_fops);	//初始化字符设备 捆绑了字符设备操作函数集
rtc->char_dev.owner = rtc->owner;	//模块所有者
}

2.3 rtc添加设备

void rtc_dev_add_device(struct rtc_device *rtc)
{
if (cdev_add(&rtc->char_dev, rtc->dev.devt, 1))	//添加字符设备
printk(KERN_WARNING "%s: failed to add char device %d:%d\n",rtc->name, MAJOR(rtc_devt), rtc->id);
else
pr_debug("%s: dev (%d:%d)\n", rtc->name,MAJOR(rtc_devt), rtc->id);
}

字符设备相关的初始化总结:

"1"分配设备号,"2.2"初始化字符设备(捆绑操作函数集),“2.3”添加字符设备

“2.1”初始化设备类 "2"注册设备文件

rtc字符设备操作函数集rtc_dev_fops是系统提供的,每次操作/dev/rtcXXX就会调用其操作函数集的方法

三.rtc设备接口

1.rtc字符设备操作函数集

static const struct file_operations rtc_dev_fops = {
.owner		= THIS_MODULE,
.llseek		= no_llseek,
.read		= rtc_dev_read,			//读方法
.poll		= rtc_dev_poll,			//轮询
.unlocked_ioctl	= rtc_dev_ioctl,	//控制
.open		= rtc_dev_open,			//打开
.release	= rtc_dev_release,		//释放
.fasync		= rtc_dev_fasync,		//异步通知
};

2.open方法

static int rtc_dev_open(struct inode *inode, struct file *file)
{
int err;
struct rtc_device *rtc = container_of(inode->i_cdev,struct rtc_device, char_dev);	//获取对应的rtc设备
const struct rtc_class_ops *ops = rtc->ops;	//获取对应的rtc设备类操作函数集
if (test_and_set_bit_lock(RTC_DEV_BUSY, &rtc->flags))	//测试是否忙,不忙则设置忙标志
return -EBUSY;
file->private_data = rtc;	//将rtc设备作为文件的私有数据
err = ops->open ? ops->open(rtc->dev.parent) : 0;	//存在open方法则调用其open方法
if (err == 0) {
spin_lock_irq(&rtc->irq_lock);
rtc->irq_data = 0;		//中断数据清0
spin_unlock_irq(&rtc->irq_lock);
return 0;
}
clear_bit_unlock(RTC_DEV_BUSY, &rtc->flags);	//清除忙标志
return err;
}

涉及两个操作函数集

a.rtc设备类操作函数集 rtc_class_ops --- 具体设备驱动提供

b.rtc字符设备操作函数集 rtc_dev_fops --- rtc子系统提供

3.ioctl方法

3.1控制命令定义

#define RTC_AIE_ON		_IO('p', 0x01)							/* Alarm int. enable on		使能RTC闹钟中断*/
#define RTC_AIE_OFF	_IO('p', 0x02)							/* ... off					禁用RTC闹钟中断*/
#define RTC_UIE_ON		_IO('p', 0x03)							/* Update int. enable on	使能更新RTC中断*/
#define RTC_UIE_OFF	_IO('p', 0x04)							/* ... off					禁能更新RTC中断*/
#define RTC_PIE_ON		_IO('p', 0x05)							/* Periodic int. enable on	使能RTC周期中断*/
#define RTC_PIE_OFF	_IO('p', 0x06)							/* ... off					禁能RTC周期中断*/
#define RTC_ALM_SET	_IOW('p', 0x07, struct rtc_time) 		/* Set alarm time  			设置闹钟时间*/
#define RTC_ALM_READ	_IOR('p', 0x08, struct rtc_time) 		/* Read alarm time 			读取闹钟时间*/
#define RTC_RD_TIME	_IOR('p', 0x09, struct rtc_time) 		/* Read RTC time   			读取时间与日期*/
#define RTC_SET_TIME	_IOW('p', 0x0a, struct rtc_time) 		/* Set RTC time    			设置时间与日期*/
#define RTC_IRQP_READ	_IOR('p', 0x0b, unsigned long)	 		/* Read IRQ rate   			读取中断频率*/
#define RTC_IRQP_SET	_IOW('p', 0x0c, unsigned long)	 		/* Set IRQ rate    			设置中断频率*/
#define RTC_WKALM_SET	_IOW('p', 0x0f, struct rtc_wkalrm)		/* Set wakeup alarm			设置唤醒闹钟*/
#define RTC_WKALM_RD	_IOR('p', 0x10, struct rtc_wkalrm)		/* Get wakeup alarm			获取唤醒闹钟*/

命令带的参数结构体:

3.1.1 rtc时间 rtc_time

struct rtc_time {	//rtc时间结构体
int tm_sec;		//秒
int tm_min;		//分
int tm_hour;	//时
int tm_mday;	//日
int tm_mon;		//月
int tm_year;	//年数(xxx-1900)
int tm_wday;	//星期几
int tm_yday;	//一年的第几天
int tm_isdst;	//夏令时
};

3.1.2 rtc闹钟 rtc_wkalrm

struct rtc_wkalrm {	//rtc闹钟结构体
unsigned char enabled;	/* 0 = alarm disabled, 1 = alarm enabled 闹钟使能开关*/
unsigned char pending;  /* 0 = alarm not pending, 1 = alarm pending 闹钟挂起*/
struct rtc_time time;	/* time the alarm is set to 闹钟时间*/
};

3.2 rtc设备控制

static long rtc_dev_ioctl(struct file *file,unsigned int cmd, unsigned long arg)
{
int err = 0;
struct rtc_device *rtc = file->private_data;	//获取rtc设备
const struct rtc_class_ops *ops = rtc->ops;	//获取rtc操作函数集
struct rtc_time tm;	//rtc时间
struct rtc_wkalrm alarm;	//rtc闹钟
void __user *uarg = (void __user *) arg;
err = mutex_lock_interruptible(&rtc->ops_lock);
if (err)
return err;
//根据命令判断调用任务是否有权限
switch (cmd) {
case RTC_EPOCH_SET:
case RTC_SET_TIME:
if (!capable(CAP_SYS_TIME))
err = -EACCES;
break;
case RTC_IRQP_SET:
if (arg > rtc->max_user_freq && !capable(CAP_SYS_RESOURCE))
err = -EACCES;
break;
case RTC_PIE_ON:
if (rtc->irq_freq > rtc->max_user_freq && !capable(CAP_SYS_RESOURCE))
err = -EACCES;
break;
}
if (err)
goto done;
/* 先调用设备驱动的类操作函数集结构体*/
if (ops->ioctl) {	//rtc操作函数集存在控制方法
err = ops->ioctl(rtc->dev.parent, cmd, arg);	//调用其控制方法
if (err != -ENOIOCTLCMD) {
mutex_unlock(&rtc->ops_lock);
return err;
}
}
//______________________________________________________________________________________
switch (cmd) {
case RTC_ALM_READ:	//读取闹钟时间
mutex_unlock(&rtc->ops_lock);
err = rtc_read_alarm(rtc, &alarm);	//3.1.3 读取闹钟时间
if (err < 0)
return err;
if (copy_to_user(uarg, &alarm.time, sizeof(tm)))	//复制到用户空间
err = -EFAULT;
return err;
case RTC_ALM_SET:	//设置闹钟
mutex_unlock(&rtc->ops_lock);
if (copy_from_user(&alarm.time, uarg, sizeof(tm)))	//拷贝到内核空间
return -EFAULT;
//初始化清除部分属性
alarm.enabled = 0;
alarm.pending = 0;
alarm.time.tm_wday = -1;
alarm.time.tm_yday = -1;
alarm.time.tm_isdst = -1;
{
unsigned long now, then;
err = rtc_read_time(rtc, &tm);	//读取时间
if (err < 0)
return err;
rtc_tm_to_time(&tm, &now);	//当前时间 转换成格里高里历法时间
alarm.time.tm_mday = tm.tm_mday;	//设置日期
alarm.time.tm_mon = tm.tm_mon;		//设置月
alarm.time.tm_year = tm.tm_year;	//设置年
err  = rtc_valid_tm(&alarm.time);	//校验时间合理性
if (err < 0)
return err;
rtc_tm_to_time(&alarm.time, &then);	//闹钟时间 转换成“Gregorian”时间
if (then < now) {	//现在的时间已经过了闹钟时间,那么就设置明天闹
rtc_time_to_tm(now + 24 * 60 * 60, &tm);	//“Gregorian”时间时间+1天 转rtc_time
alarm.time.tm_mday = tm.tm_mday;	//设置日期
alarm.time.tm_mon = tm.tm_mon;		//设置月
alarm.time.tm_year = tm.tm_year;	//设置年
}
}
return rtc_set_alarm(rtc, &alarm);	//3.1.4 设置闹钟
case RTC_RD_TIME:	//获取时间
mutex_unlock(&rtc->ops_lock);
err = rtc_read_time(rtc, &tm);		//3.1.1 获取时间
if (err < 0)
return err;
if (copy_to_user(uarg, &tm, sizeof(tm)))	//复制到用户空间
err = -EFAULT;
return err;
case RTC_SET_TIME:	//设置时间
mutex_unlock(&rtc->ops_lock);
if (copy_from_user(&tm, uarg, sizeof(tm)))	//复制到用户空间
return -EFAULT;
return rtc_set_time(rtc, &tm);	//3.1.2 设置系统时间
case RTC_PIE_ON:	//使能周期中断
err = rtc_irq_set_state(rtc, NULL, 1);	//使能周期中断
break;
case RTC_PIE_OFF:	//禁用周期中断
err = rtc_irq_set_state(rtc, NULL, 0);	//禁用周期中断
break;
case RTC_AIE_ON:	//使能闹钟中断
mutex_unlock(&rtc->ops_lock);
return rtc_alarm_irq_enable(rtc, 1);	//使能闹钟中断
case RTC_AIE_OFF:	//禁用闹钟中断
mutex_unlock(&rtc->ops_lock);
return rtc_alarm_irq_enable(rtc, 0);	//禁用闹钟中断
case RTC_UIE_ON:	//使能更新中断
mutex_unlock(&rtc->ops_lock);
return rtc_update_irq_enable(rtc, 1);	//使能更新中断
case RTC_UIE_OFF:	//禁用更新中断
mutex_unlock(&rtc->ops_lock);
return rtc_update_irq_enable(rtc, 0);	//禁用更新中断
case RTC_IRQP_SET:	//设置中断频率
err = rtc_irq_set_freq(rtc, NULL, arg);	//设置中断频率
break;
case RTC_IRQP_READ:	//读取中断频率
err = put_user(rtc->irq_freq, (unsigned long __user *)uarg);	//读取中断频率
break;
case RTC_WKALM_SET:	//设置唤醒闹钟
mutex_unlock(&rtc->ops_lock);
if (copy_from_user(&alarm, uarg, sizeof(alarm)))	//从用户空间复制
return -EFAULT;
return rtc_set_alarm(rtc, &alarm);	//设置闹钟
case RTC_WKALM_RD:	//读取唤醒闹钟
mutex_unlock(&rtc->ops_lock);
err = rtc_read_alarm(rtc, &alarm);	//读取闹钟
if (err < 0)
return err;
if (copy_to_user(uarg, &alarm, sizeof(alarm)))	//复制到用户空间
err = -EFAULT;
return err;
default:
err = -ENOTTY;
break;
}
done:
mutex_unlock(&rtc->ops_lock);
return err;
}

3.1.0 时间相关函数解析

A.api函数

int rtc_month_days(unsigned int month, unsigned int year)	//计算某年某月的天数
int rtc_year_days(unsigned int day, unsigned int month, unsigned int year)	//计算某年某月某日是该年的第几日
int rtc_valid_tm(struct rtc_time *tm)	//检测rtc时间的合理性
void rtc_time_to_tm(unsigned long time, struct rtc_time *tm)	//“Gregorian”时间转换成rtc时间
int rtc_tm_to_time(struct rtc_time *tm, unsigned long *time)	//rtc时间转换成“Gregorian”时间

“Gregorian”时间:自01-01-1970 00:00:00到现在的秒数值

rtc时钟的年数是今年减去1900年的数值

B.使用的全局数组

B.1 每个月的天数rtc_days_in_month

static const unsigned char rtc_days_in_month[] = {	//每个月的天数
31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31
};

B.2 从年头1月1日到各个月的月头经过的日子数

static const unsigned short rtc_ydays[2][13] = {
/*常年	1月,2月,3月,4月,5月,6月,7月,8月,9月,10月,11月,12月,1月*/
{ 0 ,31 ,59 ,90 ,120,151,181,212,243,273 ,304 ,334,365 },
/*闰年情况*/
{ 0 ,31 ,60 ,91 ,121,152,182,213,244,274 ,305 ,335,366 }
};

B.3 判断是否闰年

static inline bool is_leap_year(unsigned int year)	//判断是否闰年
{
return (!(year % 4) && (year % 100)) || !(year % 400);
}

B.4 计算自公元0年经过了多少个闰年

#define LEAPS_THRU_END_OF(y) ((y)/4 - (y)/100 + (y)/400)

C 函数解析

C.1 rtc_month_days

int rtc_month_days(unsigned int month, unsigned int year)
{			//month月的天数			+  是否闰年?&&是否二月份?	都是旧加多1天
return rtc_days_in_month[month] + (is_leap_year(year) && month == 1);
}
EXPORT_SYMBOL(rtc_month_days);

C.2 rtc_year_days

int rtc_year_days(unsigned int day, unsigned int month, unsigned int year)	//日期计算 是一年中的第几日
{		   //日子数[year是否闰年?][第month月]+日-1
return rtc_ydays[is_leap_year(year)][month] + day-1;
}
EXPORT_SYMBOL(rtc_year_days);

C.3 rtc_valid_tm

int rtc_valid_tm(struct rtc_time *tm)	//检测rtc时间的合理性
{
if (tm->tm_year < 70	//年分小于1970年
|| ((unsigned)tm->tm_mon) >= 12	//月份大于12月
|| tm->tm_mday < 1	//日期小于1
|| tm->tm_mday > rtc_month_days(tm->tm_mon, tm->tm_year + 1900)	//日期大于当月最大日期
|| ((unsigned)tm->tm_hour) >= 24	//时大于24
|| ((unsigned)tm->tm_min) >= 60		//分大于60
|| ((unsigned)tm->tm_sec) >= 60)	//秒大于60
return -EINVAL;
return 0;
}
EXPORT_SYMBOL(rtc_valid_tm);

C.4 rtc_time_to_tm

void rtc_time_to_tm(unsigned long time, struct rtc_time *tm)	//“Gregorian”时间转换rtc时间
{
unsigned int month, year;
int days;
days = time / 86400;	//总秒数/(24*60*60[1天的秒数])等于过去的日子数
time -= (unsigned int) days * 86400;	//剩余不足一天的秒数
tm->tm_wday = (days + 4) % 7;	//计算星期几(1970-01-01刚好是星期3所以+4)
year = 1970 + days / 365;	//计算现在是哪一年=1970+过去的日字数/365
days -= (year - 1970) * 365 + LEAPS_THRU_END_OF(year - 1) - LEAPS_THRU_END_OF(1970 - 1);
//计算剩下不足一年的日子数,并调整闰年
if (days < 0) {	//调整
year -= 1;
days += 365 + is_leap_year(year);
}
tm->tm_year = year - 1900;	//rtc时间是1900年到现在的年数
tm->tm_yday = days + 1;	//一年中的第几天
for (month = 0; month < 11; month++) {	//计算是几月几日
int newdays;
newdays = days - rtc_month_days(month, year);	//减每个月的天数
if (newdays < 0)
break;
days = newdays;
}
tm->tm_mon = month;	//月份
tm->tm_mday = days + 1;	//日期
tm->tm_hour = time / 3600;	//小时 3600=60s*60m
time -= tm->tm_hour * 3600;		//剩下不足1小时的秒数
tm->tm_min = time / 60;	//分钟
tm->tm_sec = time - tm->tm_min * 60;	//剩下不足1分钟的秒数
}
EXPORT_SYMBOL(rtc_time_to_tm);

C.5 rtc_tm_to_time

int rtc_tm_to_time(struct rtc_time *tm, unsigned long *time)	//rtc时间转换成“Gregorian”时间
{
*time = mktime(tm->tm_year + 1900, tm->tm_mon + 1, tm->tm_mday,tm->tm_hour, tm->tm_min, tm->tm_sec);
return 0;
}
EXPORT_SYMBOL(rtc_tm_to_time);

调用mktime函数 加上1900得到真正的年数,(月份+1)调整到正常的年数tm_mon是[0~11]调整成[1~12]

unsigned long mktime(const unsigned int year0, const unsigned int mon0,const unsigned int day,
const unsigned int hour,const unsigned int min, const unsigned int sec)
{
unsigned int mon = mon0, year = year0;
/* 1..12 -> 11,12,1..10 */
if (0 >= (int) (mon -= 2)) {	//判断是否过了2月份,同时mon减去2
mon += 12;	//月份+12
year -= 1;	//年份也调少1年
}
//上面调整了月份排序,也等价于,忽略1,2月份过去的天数,新调整的月份排序参考D.4
return ((((unsigned long)
(year/4 - year/100 + year/400 + 367*mon/12 + day) +	//
year*365 - 719499					// 										=总天数
)*24 + hour /* now have hours */	//日子数*24 + 剩余的小时数 				=总小时数
)*60 + min /* now have minutes */	//总小时数*60 + 剩余分数					=总分钟数
)*60 + sec; /* finally seconds */	//总分钟数*60 + 剩余秒数					=总秒数
}
EXPORT_SYMBOL(mktime);

D.针对(year/4 - year/100 + year/400 + 367*mon/12 + day) + year*365 - 719499总天数的解析

D.1 先对719499分拆,1970年1月1日00:00:00距离公元元年=(1970-1)*365+(1970/4-1970/100+1970/400)=718685+(492-19+4)=719162(1970日字数)

719499-719162=337

D.2 现在距离公元元年的整年计算(year-1)*365+(year/4 - year/100 + year/400)//可以假设是在年头1月1日00:00:00 mon=1,day=1,

结合D1结论距离1970年1月1日00:00:00可化简为:

[(year-1)*365+(year/4 - year/100 + year/400)+30]+1- 719499 + 365

[(整年日子数)+367*mon/12]+day-(1970日子数)-337 + 365

D.3 整日的计算(day-1),当天不能算,假如现在是2号,那其实只有1号是整日的,2号还没过完所以2-1

结合D.2结论调整公式:

[(year-1)*365+(year/4 - year/100 + year/400)]+ 367*mon/12 + (day-1 )- 719162 -(337+1) + 365

[(整年日子数)] + 367*mon/12 + [整日数]-(1970日子数)-(336) + 365

调整位置 [整年日字数] + [367*mon/12 -(336) + 365] + [整日数] - [1970日子数]

剩下的应该是整月日子数咯:[367*mon/12 -(336) + 365] =[367*mon/12 + 29]

D.4 新调整的月份排序,改排序等价于换了天数

1 2 3 4 5 6 7 8 9 10 11 12

31 30 31 30 31 31 30 31 30 31 31 28

由于调整把28天的放到了12月份,所以在计算某个月过去的天数的时候12月份28天,不参与进来,参与进来就按整年日子数算了

所以剩余整月日子数约等于30*(mon-1) 这里是假设每个mon都为30所以用约等于,正确值需要修正也就是把某个月有31天的情况添加进去

那么就1,3,5,6,8,10,11这几个月是31天,那就等价于要创建一个公式来表达多出来的1天的总天数 令x=mon,那么y的表达式应该是

y{

y=0 (x=1)

y=1 (x=2 ~ 3)

y=2 (x=4 ~ 5)

y=3 (x=6)

y=4 (x=7 ~ 8)

y=5 (x=9 ~ 10)

y=6 (x=11)

y=7 (x=12)

}

这个函数可以有很多表达式,这里mktime使用的表达式是 y=(x + x/6)/2 可以依次待入x检验函数

那么剩余日字数就可以表达为30*(mon-1)+(mon+mon/6)/2通分一下(分子分母都乘以6):180*(mon-1)*2/12+(6*mon+mon)/12=(360+6+1)*mon/12-30=367*mon/12-30

1月份和2月份的天数加回来:367*mon/12-30+(31+28)= 367*mon/12 + 29

D.5 总结一下

(year/4 - year/100 + year/400 + 367*mon/12 + day) + year*365 - 719499

= (year/4 - year/100 + year/400)+ (367*mon/12-30) +30 + (day-1) + 1 + (year-1)*365 + 365 - [(1970-1)*365+(1970/4-1970/100+1970/400)]-337

= {距离公元元年闰年数 + 整月日子数 + 整日数 + 整年日字数 - [1970年头到公元元年日子数]} +(30+1+365-337)

= {xxx} + (31[1月份天数]+28[2月份天数])

3.1.1 获取时间 rtc_read_time

int rtc_read_time(struct rtc_device *rtc, struct rtc_time *tm)	//读取时间
{
int err;
err = mutex_lock_interruptible(&rtc->ops_lock);
if (err)
return err;
if (!rtc->ops)	//rtc操作函数集存在
err = -ENODEV;
else if (!rtc->ops->read_time)	//不存在读时间方法
err = -EINVAL;
else {
memset(tm, 0, sizeof(struct rtc_time));	//初始化rtc_time结构体
err = rtc->ops->read_time(rtc->dev.parent, tm);	//调用读时间方法
}
mutex_unlock(&rtc->ops_lock);
return err;
}
EXPORT_SYMBOL_GPL(rtc_read_time);

3.1.2 设置系统时间 rtc_set_time

int rtc_set_time(struct rtc_device *rtc, struct rtc_time *tm)	//设置时间
{
int err;
err = rtc_valid_tm(tm);	//校验时间的合理性
if (err != 0)
return err;
err = mutex_lock_interruptible(&rtc->ops_lock);
if (err)
return err;
if (!rtc->ops)	//存在rtc操作函数集
err = -ENODEV;
else if (rtc->ops->set_time)	//存在设置时间方法
err = rtc->ops->set_time(rtc->dev.parent, tm);	//则调用设置时间方法
else if (rtc->ops->set_mmss) {	//没有则判断是否存在设置时间mmss方法
unsigned long secs;
err = rtc_tm_to_time(tm, &secs);	//转换成“Gregorian”时间
if (err == 0)
err = rtc->ops->set_mmss(rtc->dev.parent, secs);	//则调用设置时间mmss方法
}
else
err = -EINVAL;
mutex_unlock(&rtc->ops_lock);
return err;
}
EXPORT_SYMBOL_GPL(rtc_set_time);

3.1.3 读取闹钟时间

int rtc_read_alarm(struct rtc_device *rtc, struct rtc_wkalrm *alarm)	//读取闹钟
{
int err;
struct rtc_time before, now;
int first_time = 1;
unsigned long t_now, t_alm;
enum { none, day, month, year } missing = none;		//枚举可以这样写哦！
unsigned days;
err = rtc_read_time(rtc, &before);	//读取rtc时间before
if (err < 0)
return err;
do {
if (!first_time)	//重读的话,就更新before时间
memcpy(&before, &now, sizeof(struct rtc_time));
first_time = 0;
err = rtc_read_alarm_internal(rtc, alarm);	//3.1.3.1 读取rtc闹钟
if (err)
return err;
if (!alarm->enabled)
return 0;
if (rtc_valid_tm(&alarm->time) == 0)	//检测rtc时间合理性
return 0;
err = rtc_read_time(rtc, &now);	//再次读取rtc时间now
if (err < 0)
return err;
//比较分,时,月,年没发生变化(这里忽略秒级),变化了就重读
} while (before.tm_min != now.tm_min|| before.tm_hour  != now.tm_hour || before.tm_mon   != now.tm_mon || before.tm_year  != now.tm_year);
//闹钟读取失败其时间域将会置为-1
if (alarm->time.tm_sec == -1)
alarm->time.tm_sec = now.tm_sec;	//设置秒
if (alarm->time.tm_min == -1)
alarm->time.tm_min = now.tm_min;	//设置分
if (alarm->time.tm_hour == -1)
alarm->time.tm_hour = now.tm_hour;	//设置时
/* 结合后面ds1307 “3 读区闹钟ds1337_read_alarm” */
if (alarm->time.tm_mday == -1) {
alarm->time.tm_mday = now.tm_mday;	//设置日
missing = day;			//没设置日期 (05:00:00)
}
if (alarm->time.tm_mon == -1) {
alarm->time.tm_mon = now.tm_mon;	//设置月
if (missing == none)
missing = month;	//没设置月份 (xx-xx-31 05:00:00)
}
if (alarm->time.tm_year == -1) {
alarm->time.tm_year = now.tm_year;	//设置年
if (missing == none)
missing = year;		//没设置年份	(xx-2-29 05:00:00)
}
rtc_tm_to_time(&now, &t_now);	//时间转“Gregorian”时间
rtc_tm_to_time(&alarm->time, &t_alm);	//时间转“Gregorian”时间
if (t_now < t_alm)	//闹钟时间比现在时间晚,闹钟今天还会闹
goto done;
switch (missing) {
case day:		//明天闹 (现在是星期一10点,闹钟是5点,那么就得设置成星期二5点)
dev_dbg(&rtc->dev, "alarm rollover: %s\n", "day");
t_alm += 24 * 60 * 60;	//加多1天
rtc_time_to_tm(t_alm, &alarm->time);	//转成rtc时间
break;
case month:		//下个月明天闹 (如果星期一是31号了,那么星期二5点闹 还得调整下月份)
dev_dbg(&rtc->dev, "alarm rollover: %s\n", "month");
do {
if (alarm->time.tm_mon < 11)	//小于12月份
alarm->time.tm_mon++;		//月份+1
else {	//(如果是12月31日了,那么还得调整年份)
alarm->time.tm_mon = 0;		//变成1月份
alarm->time.tm_year++;		//年份+1
}
days = rtc_month_days(alarm->time.tm_mon,alarm->time.tm_year);	//闹钟日期计算出该月的天数
} while (days < alarm->time.tm_mday);	//天数不对再调整(例如设置31号闹,下个月不一定有31号)
break;
case year:		//n年后闹(闰年2月29号闹的)
dev_dbg(&rtc->dev, "alarm rollover: %s\n", "year");
do {
alarm->time.tm_year++;	//年份+1
} while (rtc_valid_tm(&alarm->time) != 0);
break;
default:
dev_warn(&rtc->dev, "alarm rollover not handled\n");
}
done:
return 0;
}
EXPORT_SYMBOL_GPL(rtc_read_alarm);

3.1.3.1 读取rtc闹钟

static int rtc_read_alarm_internal(struct rtc_device *rtc, struct rtc_wkalrm *alarm)	//读取内部时钟
{
int err;
err = mutex_lock_interruptible(&rtc->ops_lock);
if (err)
return err;
if (rtc->ops == NULL)	//存在rtc操作函数集
err = -ENODEV;
else if (!rtc->ops->read_alarm)	//存在读取闹钟方法
err = -EINVAL;
else {
memset(alarm, 0, sizeof(struct rtc_wkalrm));	//初始化rtc_wkalrm结构体对象
err = rtc->ops->read_alarm(rtc->dev.parent, alarm);	//调用读取闹钟方法
}
mutex_unlock(&rtc->ops_lock);
return err;
}

3.1.4 设置闹钟

int rtc_set_alarm(struct rtc_device *rtc, struct rtc_wkalrm *alarm)	//设置闹钟
{
int err;
err = rtc_valid_tm(&alarm->time);	//检验时间合理性
if (err != 0)
return err;
err = mutex_lock_interruptible(&rtc->ops_lock);
if (err)
return err;
if (!rtc->ops)	//存在rtc操作函数集
err = -ENODEV;
else if (!rtc->ops->set_alarm)	//不存在设置闹钟方法
err = -EINVAL;
else
err = rtc->ops->set_alarm(rtc->dev.parent, alarm);	//调用设置闹钟方法
mutex_unlock(&rtc->ops_lock);
return err;
}
EXPORT_SYMBOL_GPL(rtc_set_alarm);

3.1.4 其他

对于RTC_WKALM_RD和RTC_WKALM_SET命令跟"3.1.3"和“3.1.4”差不多,两者都会调用rtc类操作函数的读/写闹钟方法

区别在于RTC_WKALM_RD和RTC_WKALM_SET命令带的参数是rtc_wkalrm结构体,另一组命令则是rtc_time结构体

中断禁用使能函数 都是调用设备驱动提供的对应的rtc类操作函数去完成

RTC_PIE_ON		rtc_irq_set_state(rtc, NULL, 1)
RTC_PIE_OFF		rtc_irq_set_state(rtc, NULL, 0)		rtc->ops->irq_set_state(rtc->dev.parent, enabled)

RTC_AIE_ON		rtc_alarm_irq_enable(rtc, 1)
RTC_AIE_OFF		rtc_alarm_irq_enable(rtc, 0)		rtc->ops->alarm_irq_enable(rtc->dev.parent, enabled)

RTC_UIE_ON		rtc_update_irq_enable(rtc, 1)
RTC_UIE_OFF		rtc_update_irq_enable(rtc, 0)		rtc->ops->update_irq_enable(rtc->dev.parent, enabled)

中断频率设置读取函数 都是调用设备驱动提供的对应的rtc类操作函数去完成

RTC_IRQP_SET	rtc_irq_set_freq(rtc, NULL, arg)	rtc->ops->irq_set_freq(rtc->dev.parent, freq)

RTC_IRQP_READ	put_user(rtc->irq_freq, (unsigned long __user *)uarg)

4.read方法

static ssize_t rtc_dev_read(struct file *file, char __user *buf, size_t count, loff_t *ppos)
{
struct rtc_device *rtc = file->private_data;	//获取rtc设备
DECLARE_WAITQUEUE(wait, current);	//声明等待队列
unsigned long data;
ssize_t ret;
if (count != sizeof(unsigned int) && count < sizeof(unsigned long))	//判断数据长度
return -EINVAL;
add_wait_queue(&rtc->irq_queue, &wait);	//添加进等待队列
do {
__set_current_state(TASK_INTERRUPTIBLE);	//设置任务可中断态
spin_lock_irq(&rtc->irq_lock);
data = rtc->irq_data;	//获取中断数据
rtc->irq_data = 0;	//清除中断数据
spin_unlock_irq(&rtc->irq_lock);
if (data != 0) {	//数据不为0,传输正常退出while循环
ret = 0;
break;
}
if (file->f_flags & O_NONBLOCK) {	//设置文件标志
ret = -EAGAIN;
break;
}
if (signal_pending(current)) {	//挂起
ret = -ERESTARTSYS;
break;
}
schedule();
} while (1);
set_current_state(TASK_RUNNING);	//设置任务运行态
remove_wait_queue(&rtc->irq_queue, &wait);	//移出等待队列
if (ret == 0) {
/* Check for any data updates */
if (rtc->ops->read_callback)	//存在读数据回调函数
data = rtc->ops->read_callback(rtc->dev.parent,data);	//调用读数据回调函数
if (sizeof(int) != sizeof(long) && count == sizeof(unsigned int))
ret = put_user(data, (unsigned int __user *)buf) ?:sizeof(unsigned int);	//上传数据到用户空间
else
ret = put_user(data, (unsigned long __user *)buf) ?:sizeof(unsigned long);	//上传数据到用户空间
}
return ret;
}

读方法主要获取中断数据rtc->irq_data,调用rtc设备类的read_callback方法处理,并上传到用户空间,

rtc的中断数据在rtc_update_irq函数中填充,num参数是中断报告个数(存放于irq_data前8位),events代表中断事件

irq_data后8位由RTC_UF 0x10(更新中断)、RTC_AF 0x20(闹钟中断)、RTC_PF 0x40(周期中断)、RTC_IRQF 0x80

rtc_update_irq一般由设备驱动的中断处理例程或rtc_uie_task函数调用,并传递参数进来

void rtc_update_irq(struct rtc_device *rtc,unsigned long num, unsigned long events)
{
unsigned long flags;
spin_lock_irqsave(&rtc->irq_lock, flags);
rtc->irq_data = (rtc->irq_data + (num << 8)) | events;	//设置中断数据
spin_unlock_irqrestore(&rtc->irq_lock, flags);
spin_lock_irqsave(&rtc->irq_task_lock, flags);
if (rtc->irq_task)										//存在中断任务
rtc->irq_task->func(rtc->irq_task->private_data);	//调用中断任务回调函数
spin_unlock_irqrestore(&rtc->irq_task_lock, flags);
wake_up_interruptible(&rtc->irq_queue);	//唤醒等待中断的队列
kill_fasync(&rtc->async_queue, SIGIO, POLL_IN);	//轮询机制
}
EXPORT_SYMBOL_GPL(rtc_update_irq);

5.轮询poll方法

static unsigned int rtc_dev_poll(struct file *file, poll_table *wait)
{
struct rtc_device *rtc = file->private_data;	//获取RTC设备
unsigned long data;
poll_wait(file, &rtc->irq_queue, wait);	//poll等待
data = rtc->irq_data;	//获取中断数据
return (data != 0) ? (POLLIN | POLLRDNORM) : 0;
}

四.sysfs和procfs接口

1.sysfs接口

在rtc_init函数中,创建了设备类那么/sys/class/rtc节点存在

接着rtc_sysfs_init初始化设备类属性

void __init rtc_sysfs_init(struct class *rtc_class)
{
rtc_class->dev_attrs = rtc_attrs;	//设置rtc设备类属性
}

属性文件,cat对应的属性文件可以显示对应的数据信息

static struct device_attribute rtc_attrs[] = {
__ATTR(name, S_IRUGO, rtc_sysfs_show_name, NULL),	//1.1.名字
__ATTR(date, S_IRUGO, rtc_sysfs_show_date, NULL),	//1.2.日期
__ATTR(time, S_IRUGO, rtc_sysfs_show_time, NULL),	//1.3.时间
__ATTR(since_epoch, S_IRUGO, rtc_sysfs_show_since_epoch, NULL),	//1.4.“Gregorian”时间 秒数
__ATTR(max_user_freq, S_IRUGO | S_IWUSR, rtc_sysfs_show_max_user_freq,rtc_sysfs_set_max_user_freq),	//1.5.最大频率
__ATTR(hctosys, S_IRUGO, rtc_sysfs_show_hctosys, NULL),	//时间同步
{ },
};

1.1.名字

static ssize_trtc_sysfs_show_name(struct device *dev, struct device_attribute *attr,char *buf)
{
return sprintf(buf, "%s\n", to_rtc_device(dev)->name);	//根据设备文件获取rtc设备,并打印其名字
}

1.2.日期

static ssize_t rtc_sysfs_show_date(struct device *dev, struct device_attribute *attr,char *buf)
{
ssize_t retval;
struct rtc_time tm;
retval = rtc_read_time(to_rtc_device(dev), &tm);	//根据设备文件获取rtc设备,读取时间
if (retval == 0) {
retval = sprintf(buf, "%04d-%02d-%02d\n",tm.tm_year + 1900, tm.tm_mon + 1, tm.tm_mday);	//打印
}
return retval;
}

1.3.时间

static ssize_t rtc_sysfs_show_time(struct device *dev, struct device_attribute *attr,char *buf)
{
ssize_t retval;
struct rtc_time tm;
retval = rtc_read_time(to_rtc_device(dev), &tm);	//根据设备文件获取rtc设备,读取时间
if (retval == 0) {
retval = sprintf(buf, "%02d:%02d:%02d\n",tm.tm_hour, tm.tm_min, tm.tm_sec);	//打印
}
return retval;
}

1.4.“Gregorian”时间 秒数

static ssize_t rtc_sysfs_show_since_epoch(struct device *dev, struct device_attribute *attr,char *buf)
{
ssize_t retval;
struct rtc_time tm;
retval = rtc_read_time(to_rtc_device(dev), &tm);	//根据设备文件获取rtc设备,读取时间
if (retval == 0) {
unsigned long time;
rtc_tm_to_time(&tm, &time);		//时间转“Gregorian”时间
retval = sprintf(buf, "%lu\n", time);	//打印秒数
}
return retval;
}

1.5 设置和获取最大用户频率

static ssize_t rtc_sysfs_show_max_user_freq(struct device *dev, struct device_attribute *attr,char *buf)
{
return sprintf(buf, "%d\n", to_rtc_device(dev)->max_user_freq);	//根据设备文件获取rtc设备,读取最大用户频率
}
static ssize_t rtc_sysfs_set_max_user_freq(struct device *dev, struct device_attribute *attr,const char *buf, size_t n)
{
struct rtc_device *rtc = to_rtc_device(dev);	//根据设备文件获取rtc设备
unsigned long val = simple_strtoul(buf, NULL, 0);	//截取要设置的最大频率值
if (val >= 4096 || val == 0)
return -EINVAL;
rtc->max_user_freq = (int)val;	//设置用户最大使用频率
return n;
}

1.6 在rtc设备注册的时候调用了rtc_sysfs_add_device函数

void rtc_sysfs_add_device(struct rtc_device *rtc)
{
int err;
/* not all RTCs support both alarms and wakeup */
if (!rtc_does_wakealarm(rtc))	//判断rtc是否支持唤醒
return;
err = device_create_file(&rtc->dev, &dev_attr_wakealarm);	//支持则创建属性文件
if (err)
dev_err(rtc->dev.parent,"failed to create alarm attribute, %d\n", err);
}

2.procfs接口

procfs添加设备

void rtc_proc_add_device(struct rtc_device *rtc)
{
if (rtc->id == 0)
proc_create_data("driver/rtc", 0, NULL, &rtc_proc_fops, rtc);	//生成"/proc/driver/rtc"
}

捆绑了操作函数集rtc_proc_fops

static const struct file_operations rtc_proc_fops = {
.open		= rtc_proc_open,
.read		= seq_read,
.llseek		= seq_lseek,
.release	= rtc_proc_release,
};

这里涉及到seq_file文件操作,下面简单的描述一下,不对seq_file做分析

在open方法中

static int rtc_proc_open(struct inode *inode, struct file *file)
{
struct rtc_device *rtc = PDE(inode)->data;
if (!try_module_get(THIS_MODULE))
return -ENODEV;
return single_open(file, rtc_proc_show, rtc);
}

指定了显示函数rtc_proc_show

static int rtc_proc_show(struct seq_file *seq, void *offset)
{
int err;
struct rtc_device *rtc = seq->private;	//获取rtc设备
const struct rtc_class_ops *ops = rtc->ops;	//获取rtc类操作函数集
struct rtc_wkalrm alrm;
struct rtc_time tm;
err = rtc_read_time(rtc, &tm);	//读取时间
if (err == 0) {
seq_printf(seq,
"rtc_time\t: %02d:%02d:%02d\n"		//打印时间
"rtc_date\t: %04d-%02d-%02d\n",		//打印日期
tm.tm_hour, tm.tm_min, tm.tm_sec,
tm.tm_year + 1900, tm.tm_mon + 1, tm.tm_mday);
}
err = rtc_read_alarm(rtc, &alrm);	//读闹钟
if (err == 0) {
seq_printf(seq, "alrm_time\t: ");
if ((unsigned int)alrm.time.tm_hour <= 24)
seq_printf(seq, "%02d:", alrm.time.tm_hour);
else
seq_printf(seq, "**:");
if ((unsigned int)alrm.time.tm_min <= 59)
seq_printf(seq, "%02d:", alrm.time.tm_min);
else
seq_printf(seq, "**:");
if ((unsigned int)alrm.time.tm_sec <= 59)
seq_printf(seq, "%02d\n", alrm.time.tm_sec);
else
seq_printf(seq, "**\n");
seq_printf(seq, "alrm_date\t: ");
if ((unsigned int)alrm.time.tm_year <= 200)
seq_printf(seq, "%04d-", alrm.time.tm_year + 1900);
else
seq_printf(seq, "****-");
if ((unsigned int)alrm.time.tm_mon <= 11)
seq_printf(seq, "%02d-", alrm.time.tm_mon + 1);
else
seq_printf(seq, "**-");
if (alrm.time.tm_mday && (unsigned int)alrm.time.tm_mday <= 31)
seq_printf(seq, "%02d\n", alrm.time.tm_mday);
else
seq_printf(seq, "**\n");
seq_printf(seq, "alarm_IRQ\t: %s\n",alrm.enabled ? "yes" : "no");
seq_printf(seq, "alrm_pending\t: %s\n",alrm.pending ? "yes" : "no");
}
seq_printf(seq, "24hr\t\t: yes\n");	//打印
if (ops->proc)
ops->proc(rtc->dev.parent, seq);
return 0;
}

cat一下显示

/proc/driver# cat rtc

rtc_time : 01:25:57

rtc_date : 2013-11-02

24hr : yes

五.ds1307 rtc芯片设备驱动

ds1307由i2c总线控制在其初始化函数中注册了i2c设备驱动

static int __init ds1307_init(void)
{
return i2c_add_driver(&ds1307_driver);
}
module_init(ds1307_init);

i2c设备驱动结构体

static struct i2c_driver ds1307_driver = {
.driver = {
.name	= "rtc-ds1307",
.owner	= THIS_MODULE,
},
.probe		= ds1307_probe,
.remove		= __devexit_p(ds1307_remove),
.id_table	= ds1307_id,
};

当匹配到设备的时候调用probe方法既ds1307_probe

在其probe方法中调用了rtc_device_register注册rtc设备,并捆绑了ds13xx_rtc_ops操作函数集

ds1307->rtc = rtc_device_register(client->name, &client->dev,&ds13xx_rtc_ops, THIS_MODULE);

ds1307的rtc设备类操作函数集

static const struct rtc_class_ops ds13xx_rtc_ops = {
.read_time	= ds1307_get_time,		//1 读取时间
.set_time	= ds1307_set_time,		         //2 设置时间
.read_alarm	= ds1337_read_alarm,	//3 读区闹钟
.set_alarm	= ds1337_set_alarm,	//4 设置闹钟
.ioctl		= ds1307_ioctl,		//5.rtc独有控制
};

1 读取时间ds1307_get_time

static int ds1307_get_time(struct device *dev, struct rtc_time *t)
{
struct ds1307	*ds1307 = dev_get_drvdata(dev);
int		tmp;
/* read the RTC date and time registers all at once */
tmp = ds1307->read_block_data(ds1307->client,ds1307->offset, 7, ds1307->regs);	//通过i2c总线读取ds1307的寄存器
if (tmp != 7) {
dev_err(dev, "%s error %d\n", "read", tmp);
return -EIO;
}
t->tm_sec = bcd2bin(ds1307->regs[DS1307_REG_SECS] & 0x7f);	//读取秒寄存器	设置rtc时间-秒
t->tm_min = bcd2bin(ds1307->regs[DS1307_REG_MIN] & 0x7f);	//读取分寄存器	设置rtc时间-分
tmp = ds1307->regs[DS1307_REG_HOUR] & 0x3f;					//读取时寄存器
t->tm_hour = bcd2bin(tmp);									//设置rtc时间-时
t->tm_wday = bcd2bin(ds1307->regs[DS1307_REG_WDAY] & 0x07) - 1;	//读取星期寄存器	设置rtc时间-星期
t->tm_mday = bcd2bin(ds1307->regs[DS1307_REG_MDAY] & 0x3f);		//读取日寄存器	设置rtc时间-日
tmp = ds1307->regs[DS1307_REG_MONTH] & 0x1f;				//读取月寄存器
t->tm_mon = bcd2bin(tmp) - 1;								//设置rtc时间-月
/* assume 20YY not 19YY, and ignore DS1337_BIT_CENTURY */	//ds1307从20YY年计算起的不是19YY年,所以加一个世纪(好霸气！)
t->tm_year = bcd2bin(ds1307->regs[DS1307_REG_YEAR]) + 100;	//读取年寄存器	设置rtc时间-年
return rtc_valid_tm(t);	//检验时间合理性
}

2 设置时间ds1307_set_time

static int ds1307_set_time(struct device *dev, struct rtc_time *t)
{
struct ds1307	*ds1307 = dev_get_drvdata(dev);
int		result;
int		tmp;
u8		*buf = ds1307->regs;
buf[DS1307_REG_SECS] = bin2bcd(t->tm_sec);		//设置秒
buf[DS1307_REG_MIN] = bin2bcd(t->tm_min);		//设置分
buf[DS1307_REG_HOUR] = bin2bcd(t->tm_hour);		//设置时
buf[DS1307_REG_WDAY] = bin2bcd(t->tm_wday + 1);	//设置星期
buf[DS1307_REG_MDAY] = bin2bcd(t->tm_mday);		//设置日
buf[DS1307_REG_MONTH] = bin2bcd(t->tm_mon + 1);	//设置月
/* assume 20YY not 19YY */
tmp = t->tm_year - 100;	//同读方法一样,减去一个世纪
buf[DS1307_REG_YEAR] = bin2bcd(tmp);			//设置年
switch (ds1307->type) {
case ds_1337:
case ds_1339:
case ds_3231:
buf[DS1307_REG_MONTH] |= DS1337_BIT_CENTURY;
break;
case ds_1340:
buf[DS1307_REG_HOUR] |= DS1340_BIT_CENTURY_EN| DS1340_BIT_CENTURY;
break;
default:
break;
}
result = ds1307->write_block_data(ds1307->client,ds1307->offset, 7, buf);	//i2c总线写回ds1307寄存器
if (result < 0) {
dev_err(dev, "%s error %d\n", "write", result);
return result;
}
return 0;
}

3 读区闹钟ds1337_read_alarm

static int ds1337_read_alarm(struct device *dev, struct rtc_wkalrm *t)
{
struct i2c_client       *client = to_i2c_client(dev);	//获取i2c客户端
struct ds1307		*ds1307 = i2c_get_clientdata(client);
int			ret;
if (!test_bit(HAS_ALARM, &ds1307->flags))
return -EINVAL;
ret = ds1307->read_block_data(client,DS1339_REG_ALARM1_SECS, 9, ds1307->regs);	//i2c获取ds1307寄存器
if (ret != 9) {
dev_err(dev, "%s error %d\n", "alarm read", ret);
return -EIO;
}
t->time.tm_sec = bcd2bin(ds1307->regs[0] & 0x7f);	//秒
t->time.tm_min = bcd2bin(ds1307->regs[1] & 0x7f);	//分
t->time.tm_hour = bcd2bin(ds1307->regs[2] & 0x3f);	//小时
t->time.tm_mday = bcd2bin(ds1307->regs[3] & 0x3f);	//日
t->time.tm_mon = -1;	//月份没得设	结合“前面 3.1.3 读取闹钟时间”看
t->time.tm_year = -1;	//年份没得设
t->time.tm_wday = -1;	//没得设
t->time.tm_yday = -1;	//没得设
t->time.tm_isdst = -1;	//没得设
t->enabled = !!(ds1307->regs[7] & DS1337_BIT_A1IE);	//使能闹钟?
t->pending = !!(ds1307->regs[8] & DS1337_BIT_A1I);	//使能挂起?
return 0;
}

4 设置闹钟

static int ds1337_set_alarm(struct device *dev, struct rtc_wkalrm *t)
{
struct i2c_client       *client = to_i2c_client(dev);	//获取i2c客户端
struct ds1307		*ds1307 = i2c_get_clientdata(client);
unsigned char		*buf = ds1307->regs;
u8			control, status;
int			ret;
if (!test_bit(HAS_ALARM, &ds1307->flags))	//测试忙标志
return -EINVAL;
ret = ds1307->read_block_data(client,DS1339_REG_ALARM1_SECS, 9, buf);	//通过i2c总线读芯片的状态
if (ret != 9) {
dev_err(dev, "%s error %d\n", "alarm write", ret);
return -EIO;
}
control = ds1307->regs[7];
status = ds1307->regs[8];	//保存状态标志
buf[0] = bin2bcd(t->time.tm_sec);	//设置秒
buf[1] = bin2bcd(t->time.tm_min);	//设置分
buf[2] = bin2bcd(t->time.tm_hour);	//设置时
buf[3] = bin2bcd(t->time.tm_mday);	//设置日
buf[4] = 0;
buf[5] = 0;
buf[6] = 0;
buf[7] = control & ~(DS1337_BIT_A1IE | DS1337_BIT_A2IE);
if (t->enabled) {	//设置闹钟使能
dev_dbg(dev, "alarm IRQ armed\n");
buf[7] |= DS1337_BIT_A1IE;	/* only ALARM1 is used */
}
buf[8] = status & ~(DS1337_BIT_A1I | DS1337_BIT_A2I);
ret = ds1307->write_block_data(client,DS1339_REG_ALARM1_SECS, 9, buf);	//通过i2c总线写入芯片
if (ret < 0) {
dev_err(dev, "can't set alarm time\n");
return ret;
}

return 0;
}

5.rtc独有控制

ds1307支持闹钟中断的使能和禁用功能

static int ds1307_ioctl(struct device *dev, unsigned int cmd, unsigned long arg)
{
struct i2c_client	*client = to_i2c_client(dev);
struct ds1307		*ds1307 = i2c_get_clientdata(client);
int			ret;

switch (cmd) {
case RTC_AIE_OFF:
if (!test_bit(HAS_ALARM, &ds1307->flags))
return -ENOTTY;
ret = i2c_smbus_read_byte_data(client, DS1337_REG_CONTROL);	//通过i2c总线读取数据
if (ret < 0)	//判断能否控制
return ret;
ret &= ~DS1337_BIT_A1IE;
ret = i2c_smbus_write_byte_data(client,DS1337_REG_CONTROL, ret);	//通过i2c总线写入数据
if (ret < 0)
return ret;
break;
case RTC_AIE_ON:
if (!test_bit(HAS_ALARM, &ds1307->flags))
return -ENOTTY;
ret = i2c_smbus_read_byte_data(client, DS1337_REG_CONTROL);	//通过i2c总线读取数据
if (ret < 0)	//判断能否控制
return ret;
ret |= DS1337_BIT_A1IE;
ret = i2c_smbus_write_byte_data(client,DS1337_REG_CONTROL, ret);	//通过i2c总线写入数据
if (ret < 0)
return ret;
break;
default:
return -ENOIOCTLCMD;
}
return 0;
}

关于中断,在ds1307 i2c设备驱动的probe方法中

err = request_irq(client->irq, ds1307_irq, IRQF_SHARED,ds1307->rtc->name, client);

申请了中断,中断处理例程是ds1307_irq

static irqreturn_t ds1307_irq(int irq, void *dev_id)
{
struct i2c_client	*client = dev_id;
struct ds1307		*ds1307 = i2c_get_clientdata(client);
disable_irq_nosync(irq);
schedule_work(&ds1307->work);	//调用ds1307->work
return IRQ_HANDLED;
}

在probe方法中也设置了

INIT_WORK(&ds1307->work, ds1307_work);

所以中断例程回去执行ds1307_work

static void ds1307_work(struct work_struct *work)
{
struct ds1307		*ds1307;
struct i2c_client	*client;
struct mutex		*lock;
int			stat, control;
ds1307 = container_of(work, struct ds1307, work);
client = ds1307->client;
lock = &ds1307->rtc->ops_lock;
mutex_lock(lock);
stat = i2c_smbus_read_byte_data(client, DS1337_REG_STATUS);	//i2c读取ds1307状态
if (stat < 0)
goto out;
if (stat & DS1337_BIT_A1I) {
stat &= ~DS1337_BIT_A1I;
i2c_smbus_write_byte_data(client, DS1337_REG_STATUS, stat);
control = i2c_smbus_read_byte_data(client, DS1337_REG_CONTROL);	//i2c读取控制状态
if (control < 0)
goto out;
control &= ~DS1337_BIT_A1IE;
i2c_smbus_write_byte_data(client, DS1337_REG_CONTROL, control);	//i2c写入控制命令
//调用rtc_update_irq函数 设置了events为RTC_AF(闹钟中断)| RTC_IRQF
rtc_update_irq(ds1307->rtc, 1, RTC_AF | RTC_IRQF);	//结合"三.rtc设备接口-4.read方法"理解
}
out:
if (test_bit(HAS_ALARM, &ds1307->flags))
enable_irq(client->irq);
mutex_unlock(lock);
}