rtc節(jié)點(diǎn)

rtc-sysfs文件主要的操作就是在sys下創(chuàng)建rtc的屬性節(jié)點(diǎn)，可以方便用戶(hù)方便快捷的訪問(wèn)，查找問(wèn)題。下來(lái)大概看看sys下的rtc節(jié)點(diǎn)，有個(gè)直觀的認(rèn)識(shí)。

[root@test ~]# cat /sys/class/rtc/rtc0/
date hctosys power/ time?
dev max_user_freq since_epoch uevent?
device/ name subsystem/ wakealarm?
這是手機(jī)上rtc的節(jié)點(diǎn)屬性，可以看到手機(jī)上只有一個(gè)rtc0設(shè)備。也可以查看/dev/rtc0設(shè)備
[root@test ~]# ls -l /dev/rtc0?
crw-rw---- 1 root root 254, 0 Jan 1 1970 /dev/rtc0
可以看到rtc的主設(shè)備號(hào)是254， 次設(shè)備號(hào)是0。這些信息也可以在/proc/devices下看到。
[root@test ~]# cat /proc/devices?
Character devices:
1 mem
2 pty
...
254 rtc
也可以看到rtc的主設(shè)備號(hào)是254， 這都是通過(guò)上一節(jié)說(shuō)的rtc-dev.c中注冊(cè)得到的。

rtc-sysfs.c分析
void __init rtc_sysfs_init(struct class *rtc_class)
{
rtc_class->dev_groups = rtc_groups;
}
設(shè)置rtc的設(shè)備組屬性，rtc_groups是一個(gè)attribute_group的結(jié)構(gòu)體。這個(gè)函數(shù)會(huì)在class.c中rtc_init中調(diào)用到，關(guān)于rtc_group會(huì)在后面說(shuō)到。

static inline int rtc_does_wakealarm(struct rtc_device *rtc)
{
if (!device_can_wakeup(rtc->dev.parent)) //用來(lái)判斷是否具有wakeup的能力
return 0;?
return rtc->ops->set_alarm != NULL; //用來(lái)判斷是否具有alarm的能力
}
該函數(shù)是用來(lái)檢測(cè)rtc是否支持wakeup功能和alarm功能。 wakeup的能力就是能喚醒suspend-to-RAM/suspend-to-disk設(shè)備。wakeup的能力是通過(guò)如下代碼：
static inline bool device_can_wakeup(struct device *dev)
{
return dev->power.can_wakeup;
}
也就是判斷can_wakeup是否為true，至于rtc是否支持就需要看對(duì)應(yīng)的rtc驅(qū)動(dòng)是否實(shí)現(xiàn)該功能。
比如驅(qū)動(dòng)： rtc-ds1305.c中就調(diào)用如下的代碼設(shè)置wakeup的能力。
device_set_wakeup_capable(&spi->dev, 1);
也可以通過(guò)如下方式判斷是否支持wakeup功能：
root@test:/ # cat /sys/class/rtc/rtc0/device/power/wakeup
enabled
顯示enabled就代表此rtc支持 wakeup功能，也就是說(shuō)有喚醒suspend/standby的系統(tǒng)或者設(shè)備。

而對(duì)于rtc是否支持alarm功能，就通過(guò)驅(qū)動(dòng)的ops操作函數(shù)集合看set_alarm有沒(méi)有實(shí)現(xiàn)就ok。
如果rtc即支持wakeup功能也支持alarm功能，則：
void rtc_sysfs_add_device(struct rtc_device *rtc)
{
int err;

/* not all RTCs support both alarms and wakeup */
if (!rtc_does_wakealarm(rtc)) //檢測(cè)是否支持wakeup和alarm功能
return;

err = device_create_file(&rtc->dev, &dev_attr_wakealarm); //創(chuàng)建wakealarm屬性
if (err)
dev_err(rtc->dev.parent,
"failed to create alarm attribute, %d\n", err);
}
如果rtc都支持wakup和alarm功能，就創(chuàng)建wakealarm屬性節(jié)點(diǎn)。否則不創(chuàng)建。

接下來(lái)分析wakealarm屬性的show和store函數(shù)。
static DEVICE_ATTR(wakealarm, S_IRUGO | S_IWUSR, rtc_sysfs_show_wakealarm, rtc_sysfs_set_wakealarm);
這里出現(xiàn)了DEVICE_ATTR，有必要說(shuō)一下這個(gè)宏定義。

---------------------------------------------------------------------------------
#define DEVICE_ATTR(_name, _mode, _show, _store) \
struct device_attribute dev_attr_##_name = __ATTR(_name, _mode, _show, _store)
#define __ATTR(_name, _mode, _show, _store) { \
.attr = {.name = __stringify(_name), \
.mode = VERIFY_OCTAL_PERMISSIONS(_mode) }, \
.show = _show, \
.store = _store, \
}

以上就是DEVICE_ATTR的宏定義，則按照定義將wakealarm的屬性展開(kāi)，如下：
struct device_attribute dev_attr_wakealarm {
.name = wakealarm,
.mode = S_IRUGO | S_IWUSR,
.show = rtc_sysfs_show_wakealarm,
.store = rtc_sysfs_set_wakealarm,
}
上面的屬性可以知道，wakealarm的屬性為可讀可寫(xiě)的，當(dāng)cat wakealarm的時(shí)候最終調(diào)用show函數(shù)，echo的時(shí)候最終調(diào)用strore函數(shù)。
root@test:/ # cat /sys/class/rtc/rtc0/wakealarm?
root@test:/ #?
當(dāng)讀wakealarm的時(shí)候，沒(méi)有任何值，說(shuō)明目前沒(méi)有設(shè)備alarm。
也可以通過(guò)cat /proc/driver/rtc獲得更多的信息：
rtc_time : 07:07:46
rtc_date : 2012-01-01
alrm_time : 00:00:00
alrm_date : 1970-01-01
alarm_IRQ : no
alrm_pending : no
update IRQ enabled : no
periodic IRQ enabled : no
periodic IRQ frequency : 1
max user IRQ frequency : 64
24hr : yes
可以看到alarm_IRQ是no， 當(dāng)設(shè)置正確的alarm值后就會(huì)變?yōu)閥es的。接下來(lái)設(shè)置當(dāng)前的時(shí)間之后的100s
root@test:/ # echo +100 > /sys/class/rtc/rtc0/wakealarm?
root@test:/ # cat /proc/driver/rtc?
rtc_time : 07:09:32
rtc_date : 2012-01-01
alrm_time : 07:11:05
alrm_date : 2012-01-01
alarm_IRQ : yes
alrm_pending : no
update IRQ enabled : no
periodic IRQ enabled : no
periodic IRQ frequency : 1
max user IRQ frequency : 64
24hr : yes
可以看到alrm_time變?yōu)楫?dāng)前時(shí)間+100s了，同時(shí)alarm_IRQ也變?yōu)閥es。
同時(shí)再次cat wakealarm，即可獲得值。
root@test:/ # cat /sys/class/rtc/rtc0/wakealarm?
1325401865
此值是unix的時(shí)間戳，必須要轉(zhuǎn)換為UTC時(shí)間，可以通過(guò)如下的網(wǎng)址轉(zhuǎn)換，http://tool.chinaz.com/Tools/unixtime.aspx

可以看到轉(zhuǎn)換后的時(shí)間是2012/1/1 15:11:5,為什么感覺(jué)和alrm_time對(duì)不上呢? 那是因?yàn)楸本┰跂|八區(qū)，相差8個(gè)小時(shí)，15-8=7則就是alrm_time。
當(dāng)cat wakealarm有值的時(shí)候，再次echo值進(jìn)如wakealarm的時(shí)候就會(huì)出現(xiàn)設(shè)備忙，所以再次設(shè)備時(shí)候必須清除以前的設(shè)置。
root@test:/ # cat /sys/class/rtc/rtc0/wakealarm?
1325401865
root@test:/ # echo +100 > /sys/class/rtc/rtc0/wakealarm
sh: echo: write error: Device or resource busy
那如何就可以清空wakealarm的值，可以通過(guò)echo 0 > wakealarm就可以清空
root@test:/ # cat /sys/class/rtc/rtc0/wakealarm
1325401865
root@test:/ # echo 0 > /sys/class/rtc/rtc0/wakealarm
root@test:/ # cat /sys/class/rtc/rtc0/wakealarm
root@test:/ #
在知道了上述的設(shè)置之后，再來(lái)看代碼，在看代碼之前先看一下必要的數(shù)據(jù)結(jié)構(gòu)。
struct rtc_time {
int tm_sec; //秒
int tm_min; //分鐘
int tm_hour; //小時(shí)
int tm_mday; //一月中的第幾天
int tm_mon; //月份
int tm_year; //年份
int tm_wday; //周
int tm_yday; //一年中的第幾天
int tm_isdst; //夏令時(shí)標(biāo)識(shí)符
};

/*
* This data structure is inspired by the EFI (v0.92) wakeup
* alarm API.
*/
struct rtc_wkalrm {
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 */
};
先分析store函數(shù)，當(dāng)之后往里面寫(xiě)值的之后，才可以read出來(lái)。
static ssize_t
rtc_sysfs_set_wakealarm(struct device *dev, struct device_attribute *attr, const char *buf, size_t n)
{
ssize_t retval;
unsigned long now, alarm;
unsigned long push = 0;
struct rtc_wkalrm alm;
struct rtc_device *rtc = to_rtc_device(dev);
char *buf_ptr;
int adjust = 0;

/* Only request alarms that trigger in the future. Disable them
* by writing another time, e.g. 0 meaning Jan 1 1970 UTC. //設(shè)置時(shí)間必須是在將來(lái)
*/
retval = rtc_read_time(rtc, &alm.time); //讀取當(dāng)前時(shí)間
if (retval < 0)
return retval;
rtc_tm_to_time(&alm.time, &now); //將當(dāng)前的時(shí)間轉(zhuǎn)化為從1970來(lái)經(jīng)歷的秒數(shù)

buf_ptr = (char *)buf;
if (*buf_ptr == '+') { //如果按照我們上面的設(shè)置，echo +100 > wakealarm, 則buf就是+100， 然后解析buf
buf_ptr++;
if (*buf_ptr == '=') {
buf_ptr++;
push = 1;
} else
adjust = 1; //執(zhí)行到這里
}
alarm = simple_strtoul(buf_ptr, NULL, 0); //將“100”轉(zhuǎn)化為數(shù)字
if (adjust) {
alarm += now; //alarm就是當(dāng)前時(shí)間+100
}
if (alarm > now || push) {
/* Avoid accidentally clobbering active alarms; we can't
* entirely prevent that here, without even the minimal
* locking from the /dev/rtcN api.
*/
retval = rtc_read_alarm(rtc, &alm); //讀取alarm時(shí)間
if (retval < 0)
return retval;
if (alm.enabled) { //第一次是沒(méi)有使能的，如果第二次設(shè)置的話
if (push) {
rtc_tm_to_time(&alm.time, &push);
alarm += push;
} else
return -EBUSY; //就會(huì)出現(xiàn)設(shè)備忙，在上面已經(jīng)演示過(guò)了
} else if (push)
return -EINVAL;
alm.enabled = 1; //先使能
} else {
alm.enabled = 0;

/* Provide a valid future alarm time. Linux isn't EFI,
* this time won't be ignored when disabling the alarm.
*/
alarm = now + 300;
}
rtc_time_to_tm(alarm, &alm.time); //又將秒數(shù)設(shè)置為農(nóng)歷時(shí)間格式

retval = rtc_set_alarm(rtc, &alm); //設(shè)置alarm時(shí)間
return (retval < 0) ? retval : n;
}
下面分析read操作，最終調(diào)用show函數(shù)。
static ssize_t rtc_sysfs_show_wakealarm(struct device *dev, struct device_attribute *attr, char *buf)
{
ssize_t retval;
unsigned long alarm;
struct rtc_wkalrm alm;

/* Don't show disabled alarms. For uniformity, RTC alarms are
* conceptually one-shot, even though some common RTCs (on PCs)
* don't actually work that way.
*
* NOTE: RTC implementations where the alarm doesn't match an
* exact YYYY-MM-DD HH:MM[:SS] date *must* disable their RTC
* alarms after they trigger, to ensure one-shot semantics.
*/
retval = rtc_read_alarm(to_rtc_device(dev), &alm); //讀取alarm的值
if (retval == 0 && alm.enabled) { //如果enable了，然后顯示
rtc_tm_to_time(&alm.time, &alarm);
retval = sprintf(buf, "%lu\n", alarm);
}
return retval;
分析完wakealarm節(jié)點(diǎn)之后，還有一系列節(jié)點(diǎn)是rtc共有的，如下：
static struct attribute *rtc_attrs[] = {
&dev_attr_name.attr,
&dev_attr_date.attr,
&dev_attr_time.attr,
&dev_attr_since_epoch.attr,
&dev_attr_max_user_freq.attr,
&dev_attr_hctosys.attr,
NULL,
};
ATTRIBUTE_GROUPS(rtc);
在這里需要將ATTRIBUTE_GROOUP(rtc)展開(kāi)，展開(kāi)之后就是：
static const struct attribute_group rtc_group = {
.attrs = rtc_attrs,
}
static const struct attribute_group *rtc_groups[]={
&rtc_group,
null
}
而rtc_groups就是在rtc_sysfs_init賦值給dev_groups的。 在device_add_attrs函數(shù)中會(huì)添加這些屬性，如下：
static int device_add_attrs(struct device *dev)
{
struct class *class = dev->class;
const struct device_type *type = dev->type;
int error;

if (class) {
error = device_add_groups(dev, class->dev_groups);
if (error)
return error;
}
明白上述的創(chuàng)建原理之后，再依次看每個(gè)節(jié)點(diǎn)的意思。
static ssize_t name_show(struct device *dev, struct device_attribute *attr, char *buf)
{
return sprintf(buf, "%s\n", to_rtc_device(dev)->name);
}
static DEVICE_ATTR_RO(name);
只讀屬性，顯示rtc設(shè)備的名稱(chēng)，在驅(qū)動(dòng)中會(huì)有該rtc對(duì)應(yīng)的名稱(chēng)。
static ssize_t date_show(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);
if (retval == 0) {
retval = sprintf(buf, "%04d-%02d-%02d\n",
tm.tm_year + 1900, tm.tm_mon + 1, tm.tm_mday);
}

return retval;
}
static DEVICE_ATTR_RO(date);

static ssize_t time_show(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);
if (retval == 0) {
retval = sprintf(buf, "%02d:%02d:%02d\n",
tm.tm_hour, tm.tm_min, tm.tm_sec);
}

return retval;
}
static DEVICE_ATTR_RO(time);
上述的兩個(gè)只讀屬性，一個(gè)是當(dāng)前的時(shí)間，一個(gè)是當(dāng)前的日期，不做過(guò)多解釋。
static ssize_t since_epoch_show(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);
if (retval == 0) {
unsigned long time;
rtc_tm_to_time(&tm, &time);
retval = sprintf(buf, "%lu\n", time);
}

return retval;
}
static DEVICE_ATTR_RO(since_epoch);
只讀屬性，該屬性的值表示當(dāng)前的時(shí)間轉(zhuǎn)換為自1970年來(lái)的秒數(shù)。
static ssize_t max_user_freq_show(struct device *dev, struct device_attribute *attr, char *buf)
{
return sprintf(buf, "%d\n", to_rtc_device(dev)->max_user_freq);
}

static ssize_t max_user_freq_store(struct device *dev, struct device_attribute *attr,
const char *buf, size_t n)
{
struct rtc_device *rtc = to_rtc_device(dev);
unsigned long val = simple_strtoul(buf, NULL, 0);

if (val >= 4096 || val == 0)
return -EINVAL;

rtc->max_user_freq = (int)val;

return n;
}
static DEVICE_ATTR_RW(max_user_freq);
可讀可寫(xiě)屬性，show函數(shù)是讀取最大的freq， store是設(shè)置最大的頻率，不能超過(guò)4096.

/**
* rtc_sysfs_show_hctosys - indicate if the given RTC set the system time
*
* Returns 1 if the system clock was set by this RTC at the last
* boot or resume event.
*/
static ssize_t hctosys_show(struct device *dev, struct device_attribute *attr, char *buf)
{
#ifdef CONFIG_RTC_HCTOSYS_DEVICE
if (rtc_hctosys_ret == 0 &&
strcmp(dev_name(&to_rtc_device(dev)->dev),
CONFIG_RTC_HCTOSYS_DEVICE) == 0)
return sprintf(buf, "1\n");
else
#endif
return sprintf(buf, "0\n");
}
static DEVICE_ATTR_RO(hctosys);
只讀屬性，如果返回1代表系統(tǒng)的clock最近一次使用rtc設(shè)置。返回0代表沒(méi)有。

?