2 * EFI Time Services Driver for Linux
4 * Copyright (C) 1999 Hewlett-Packard Co
5 * Copyright (C) 1999 Stephane Eranian <eranian@hpl.hp.com>
7 * Based on skeleton from the drivers/char/rtc.c driver by P. Gortmaker
9 * This code provides a architected & portable interface to the real time
10 * clock by using EFI instead of direct bit fiddling. The functionalities are
11 * quite different from the rtc.c driver. The only way to talk to the device
12 * is by using ioctl(). There is a /proc interface which provides the raw
15 * Please note that we have kept the API as close as possible from the
16 * legacy RTC. The standard /sbin/hwclock program should work normally
17 * when used to get/set the time.
20 * - Locking is required for safe execution of EFI calls with regards
21 * to interrrupts and SMP.
23 * TODO (December 1999):
24 * - provide the API to set/get the WakeUp Alarm (different from the
27 * - Add module support
31 #include <linux/types.h>
32 #include <linux/errno.h>
33 #include <linux/miscdevice.h>
34 #include <linux/init.h>
35 #include <linux/rtc.h>
36 #include <linux/proc_fs.h>
39 #include <asm/uaccess.h>
40 #include <asm/system.h>
42 #define EFI_RTC_VERSION "0.2"
44 #define EFI_ISDST (EFI_TIME_ADJUST_DAYLIGHT|EFI_TIME_IN_DAYLIGHT)
46 * EFI Epoch is 1/1/1998
48 #define EFI_RTC_EPOCH 1998
50 static spinlock_t efi_rtc_lock
= SPIN_LOCK_UNLOCKED
;
52 static int efi_rtc_ioctl(struct inode
*inode
, struct file
*file
,
53 unsigned int cmd
, unsigned long arg
);
55 #define is_leap(year) \
56 ((year) % 4 == 0 && ((year) % 100 != 0 || (year) % 400 == 0))
58 static const unsigned short int __mon_yday
[2][13] =
61 { 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365 },
63 { 0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 366 }
67 * returns day of the year [0-365]
70 compute_yday(efi_time_t
*eft
)
72 /* efi_time_t.month is in the [1-12] so, we need -1 */
73 return __mon_yday
[is_leap(eft
->year
)][eft
->month
-1]+ eft
->day
-1;
76 * returns day of the week [0-6] 0=Sunday
78 * Don't try to provide a year that's before 1998, please !
81 compute_wday(efi_time_t
*eft
)
86 if ( eft
->year
< 1998 ) {
87 printk(KERN_ERR
"efirtc: EFI year < 1998, invalid date\n");
91 for(y
=EFI_RTC_EPOCH
; y
< eft
->year
; y
++ ) {
92 ndays
+= 365 + (is_leap(y
) ? 1 : 0);
94 ndays
+= compute_yday(eft
);
97 * 4=1/1/1998 was a Thursday
99 return (ndays
+ 4) % 7;
103 convert_to_efi_time(struct rtc_time
*wtime
, efi_time_t
*eft
)
106 eft
->year
= wtime
->tm_year
+ 1900;
107 eft
->month
= wtime
->tm_mon
+ 1;
108 eft
->day
= wtime
->tm_mday
;
109 eft
->hour
= wtime
->tm_hour
;
110 eft
->minute
= wtime
->tm_min
;
111 eft
->second
= wtime
->tm_sec
;
113 eft
->daylight
= wtime
->tm_isdst
? EFI_ISDST
: 0;
114 eft
->timezone
= EFI_UNSPECIFIED_TIMEZONE
;
118 convert_from_efi_time(efi_time_t
*eft
, struct rtc_time
*wtime
)
120 wtime
->tm_sec
= eft
->second
;
121 wtime
->tm_min
= eft
->minute
;
122 wtime
->tm_hour
= eft
->hour
;
123 wtime
->tm_mday
= eft
->day
;
124 wtime
->tm_mon
= eft
->month
- 1;
125 wtime
->tm_year
= eft
->year
- 1900;
127 /* day of the week [0-6], Sunday=0 */
128 wtime
->tm_wday
= compute_wday(eft
);
130 /* day in the year [1-365]*/
131 wtime
->tm_yday
= compute_yday(eft
);
134 switch (eft
->daylight
& EFI_ISDST
) {
138 case EFI_TIME_ADJUST_DAYLIGHT
:
142 wtime
->tm_isdst
= -1;
147 efi_rtc_ioctl(struct inode
*inode
, struct file
*file
, unsigned int cmd
,
155 struct rtc_time wtime
;
156 struct rtc_wkalrm
*ewp
;
157 unsigned char enabled
, pending
;
176 spin_lock_irqsave(&efi_rtc_lock
, flags
);
178 status
= efi
.get_time(&eft
, &cap
);
180 spin_unlock_irqrestore(&efi_rtc_lock
,flags
);
182 if (status
!= EFI_SUCCESS
) {
183 /* should never happen */
184 printk(KERN_ERR
"efitime: can't read time\n");
188 convert_from_efi_time(&eft
, &wtime
);
190 return copy_to_user((void *)arg
, &wtime
, sizeof (struct rtc_time
)) ? - EFAULT
: 0;
194 if (!capable(CAP_SYS_TIME
)) return -EACCES
;
196 if (copy_from_user(&wtime
, (struct rtc_time
*)arg
, sizeof(struct rtc_time
)) )
199 convert_to_efi_time(&wtime
, &eft
);
201 spin_lock_irqsave(&efi_rtc_lock
, flags
);
203 status
= efi
.set_time(&eft
);
205 spin_unlock_irqrestore(&efi_rtc_lock
,flags
);
207 return status
== EFI_SUCCESS
? 0 : -EINVAL
;
211 if (!capable(CAP_SYS_TIME
)) return -EACCES
;
213 ewp
= (struct rtc_wkalrm
*)arg
;
215 if ( get_user(enabled
, &ewp
->enabled
)
216 || copy_from_user(&wtime
, &ewp
->time
, sizeof(struct rtc_time
)) )
219 convert_to_efi_time(&wtime
, &eft
);
221 spin_lock_irqsave(&efi_rtc_lock
, flags
);
224 * As of EFI 0.92 with the firmware I have on my
225 * machine this call does not seem to work quite
228 status
= efi
.set_wakeup_time((efi_bool_t
)enabled
, &eft
);
230 spin_unlock_irqrestore(&efi_rtc_lock
,flags
);
232 return status
== EFI_SUCCESS
? 0 : -EINVAL
;
236 spin_lock_irqsave(&efi_rtc_lock
, flags
);
238 status
= efi
.get_wakeup_time((efi_bool_t
*)&enabled
, (efi_bool_t
*)&pending
, &eft
);
240 spin_unlock_irqrestore(&efi_rtc_lock
,flags
);
242 if (status
!= EFI_SUCCESS
) return -EINVAL
;
244 ewp
= (struct rtc_wkalrm
*)arg
;
246 if ( put_user(enabled
, &ewp
->enabled
)
247 || put_user(pending
, &ewp
->pending
)) return -EFAULT
;
249 convert_from_efi_time(&eft
, &wtime
);
251 return copy_to_user((void *)&ewp
->time
, &wtime
, sizeof(struct rtc_time
));
257 * We enforce only one user at a time here with the open/close.
258 * Also clear the previous interrupt data on an open, and clean
259 * up things on a close.
263 efi_rtc_open(struct inode
*inode
, struct file
*file
)
266 * nothing special to do here
267 * We do accept multiple open files at the same time as we
268 * synchronize on the per call operation.
274 efi_rtc_close(struct inode
*inode
, struct file
*file
)
280 * The various file operations we support.
283 static struct file_operations efi_rtc_fops
= {
285 ioctl
: efi_rtc_ioctl
,
287 release
: efi_rtc_close
,
290 static struct miscdevice efi_rtc_dev
=
298 * We export RAW EFI information to /proc/efirtc
301 efi_rtc_get_status(char *buf
)
306 efi_bool_t enabled
, pending
;
309 spin_lock_irqsave(&efi_rtc_lock
, flags
);
311 efi
.get_time(&eft
, &cap
);
312 efi
.get_wakeup_time(&enabled
, &pending
, &alm
);
314 spin_unlock_irqrestore(&efi_rtc_lock
,flags
);
326 eft
.year
, eft
.month
, eft
.day
, eft
.hour
, eft
.minute
,
327 eft
.second
, eft
.nanosecond
, eft
.daylight
);
329 if ( eft
.timezone
== EFI_UNSPECIFIED_TIMEZONE
)
330 p
+= sprintf(p
, "Timezone : unspecified\n");
332 /* XXX fixme: convert to string? */
333 p
+= sprintf(p
, "Timezone : %u\n", eft
.timezone
);
348 enabled
== 1 ? "Yes" : "No",
349 pending
== 1 ? "Yes" : "No",
350 alm
.year
, alm
.month
, alm
.day
, alm
.hour
, alm
.minute
,
351 alm
.second
, alm
.nanosecond
, alm
.daylight
);
353 if ( eft
.timezone
== EFI_UNSPECIFIED_TIMEZONE
)
354 p
+= sprintf(p
, "Timezone : unspecified\n");
356 /* XXX fixme: convert to string? */
357 p
+= sprintf(p
, "Timezone : %u\n", eft
.timezone
);
360 * now prints the capabilities
367 cap
.resolution
, cap
.accuracy
, cap
.sets_to_zero
);
373 efi_rtc_read_proc(char *page
, char **start
, off_t off
,
374 int count
, int *eof
, void *data
)
376 int len
= efi_rtc_get_status(page
);
377 if (len
<= off
+count
) *eof
= 1;
380 if (len
>count
) len
= count
;
388 printk(KERN_INFO
"EFI Time Services Driver v%s\n", EFI_RTC_VERSION
);
390 misc_register(&efi_rtc_dev
);
392 create_proc_read_entry ("efirtc", 0, NULL
, efi_rtc_read_proc
, NULL
);
404 module_init(efi_rtc_init
);
405 module_exit(efi_rtc_exit
);