[SCSI] Add Documentation and integrate into docbook build
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / drivers / rtc / rtc-ds1742.c
blob2e73f0b183b2fd94540cc6624c0d2281cfc72950
1 /*
2 * An rtc driver for the Dallas DS1742
4 * Copyright (C) 2006 Atsushi Nemoto <anemo@mba.ocn.ne.jp>
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 2 as
8 * published by the Free Software Foundation.
10 * Copyright (C) 2006 Torsten Ertbjerg Rasmussen <tr@newtec.dk>
11 * - nvram size determined from resource
12 * - this ds1742 driver now supports ds1743.
15 #include <linux/bcd.h>
16 #include <linux/init.h>
17 #include <linux/kernel.h>
18 #include <linux/delay.h>
19 #include <linux/jiffies.h>
20 #include <linux/rtc.h>
21 #include <linux/platform_device.h>
22 #include <linux/io.h>
24 #define DRV_VERSION "0.3"
26 #define RTC_SIZE 8
28 #define RTC_CONTROL 0
29 #define RTC_CENTURY 0
30 #define RTC_SECONDS 1
31 #define RTC_MINUTES 2
32 #define RTC_HOURS 3
33 #define RTC_DAY 4
34 #define RTC_DATE 5
35 #define RTC_MONTH 6
36 #define RTC_YEAR 7
38 #define RTC_CENTURY_MASK 0x3f
39 #define RTC_SECONDS_MASK 0x7f
40 #define RTC_DAY_MASK 0x07
42 /* Bits in the Control/Century register */
43 #define RTC_WRITE 0x80
44 #define RTC_READ 0x40
46 /* Bits in the Seconds register */
47 #define RTC_STOP 0x80
49 /* Bits in the Day register */
50 #define RTC_BATT_FLAG 0x80
52 struct rtc_plat_data {
53 struct rtc_device *rtc;
54 void __iomem *ioaddr_nvram;
55 void __iomem *ioaddr_rtc;
56 size_t size_nvram;
57 size_t size;
58 resource_size_t baseaddr;
59 unsigned long last_jiffies;
62 static int ds1742_rtc_set_time(struct device *dev, struct rtc_time *tm)
64 struct platform_device *pdev = to_platform_device(dev);
65 struct rtc_plat_data *pdata = platform_get_drvdata(pdev);
66 void __iomem *ioaddr = pdata->ioaddr_rtc;
67 u8 century;
69 century = BIN2BCD((tm->tm_year + 1900) / 100);
71 writeb(RTC_WRITE, ioaddr + RTC_CONTROL);
73 writeb(BIN2BCD(tm->tm_year % 100), ioaddr + RTC_YEAR);
74 writeb(BIN2BCD(tm->tm_mon + 1), ioaddr + RTC_MONTH);
75 writeb(BIN2BCD(tm->tm_wday) & RTC_DAY_MASK, ioaddr + RTC_DAY);
76 writeb(BIN2BCD(tm->tm_mday), ioaddr + RTC_DATE);
77 writeb(BIN2BCD(tm->tm_hour), ioaddr + RTC_HOURS);
78 writeb(BIN2BCD(tm->tm_min), ioaddr + RTC_MINUTES);
79 writeb(BIN2BCD(tm->tm_sec) & RTC_SECONDS_MASK, ioaddr + RTC_SECONDS);
81 /* RTC_CENTURY and RTC_CONTROL share same register */
82 writeb(RTC_WRITE | (century & RTC_CENTURY_MASK), ioaddr + RTC_CENTURY);
83 writeb(century & RTC_CENTURY_MASK, ioaddr + RTC_CONTROL);
84 return 0;
87 static int ds1742_rtc_read_time(struct device *dev, struct rtc_time *tm)
89 struct platform_device *pdev = to_platform_device(dev);
90 struct rtc_plat_data *pdata = platform_get_drvdata(pdev);
91 void __iomem *ioaddr = pdata->ioaddr_rtc;
92 unsigned int year, month, day, hour, minute, second, week;
93 unsigned int century;
95 /* give enough time to update RTC in case of continuous read */
96 if (pdata->last_jiffies == jiffies)
97 msleep(1);
98 pdata->last_jiffies = jiffies;
99 writeb(RTC_READ, ioaddr + RTC_CONTROL);
100 second = readb(ioaddr + RTC_SECONDS) & RTC_SECONDS_MASK;
101 minute = readb(ioaddr + RTC_MINUTES);
102 hour = readb(ioaddr + RTC_HOURS);
103 day = readb(ioaddr + RTC_DATE);
104 week = readb(ioaddr + RTC_DAY) & RTC_DAY_MASK;
105 month = readb(ioaddr + RTC_MONTH);
106 year = readb(ioaddr + RTC_YEAR);
107 century = readb(ioaddr + RTC_CENTURY) & RTC_CENTURY_MASK;
108 writeb(0, ioaddr + RTC_CONTROL);
109 tm->tm_sec = BCD2BIN(second);
110 tm->tm_min = BCD2BIN(minute);
111 tm->tm_hour = BCD2BIN(hour);
112 tm->tm_mday = BCD2BIN(day);
113 tm->tm_wday = BCD2BIN(week);
114 tm->tm_mon = BCD2BIN(month) - 1;
115 /* year is 1900 + tm->tm_year */
116 tm->tm_year = BCD2BIN(year) + BCD2BIN(century) * 100 - 1900;
118 if (rtc_valid_tm(tm) < 0) {
119 dev_err(dev, "retrieved date/time is not valid.\n");
120 rtc_time_to_tm(0, tm);
122 return 0;
125 static const struct rtc_class_ops ds1742_rtc_ops = {
126 .read_time = ds1742_rtc_read_time,
127 .set_time = ds1742_rtc_set_time,
130 static ssize_t ds1742_nvram_read(struct kobject *kobj,
131 struct bin_attribute *bin_attr,
132 char *buf, loff_t pos, size_t size)
134 struct platform_device *pdev =
135 to_platform_device(container_of(kobj, struct device, kobj));
136 struct rtc_plat_data *pdata = platform_get_drvdata(pdev);
137 void __iomem *ioaddr = pdata->ioaddr_nvram;
138 ssize_t count;
140 for (count = 0; size > 0 && pos < pdata->size_nvram; count++, size--)
141 *buf++ = readb(ioaddr + pos++);
142 return count;
145 static ssize_t ds1742_nvram_write(struct kobject *kobj,
146 struct bin_attribute *bin_attr,
147 char *buf, loff_t pos, size_t size)
149 struct platform_device *pdev =
150 to_platform_device(container_of(kobj, struct device, kobj));
151 struct rtc_plat_data *pdata = platform_get_drvdata(pdev);
152 void __iomem *ioaddr = pdata->ioaddr_nvram;
153 ssize_t count;
155 for (count = 0; size > 0 && pos < pdata->size_nvram; count++, size--)
156 writeb(*buf++, ioaddr + pos++);
157 return count;
160 static struct bin_attribute ds1742_nvram_attr = {
161 .attr = {
162 .name = "nvram",
163 .mode = S_IRUGO | S_IWUSR,
165 .read = ds1742_nvram_read,
166 .write = ds1742_nvram_write,
167 /* REVISIT: size in sysfs won't match actual size... if it's
168 * not a constant, each RTC should have its own attribute.
172 static int __devinit ds1742_rtc_probe(struct platform_device *pdev)
174 struct rtc_device *rtc;
175 struct resource *res;
176 unsigned int cen, sec;
177 struct rtc_plat_data *pdata = NULL;
178 void __iomem *ioaddr = NULL;
179 int ret = 0;
181 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
182 if (!res)
183 return -ENODEV;
184 pdata = kzalloc(sizeof(*pdata), GFP_KERNEL);
185 if (!pdata)
186 return -ENOMEM;
187 pdata->size = res->end - res->start + 1;
188 if (!request_mem_region(res->start, pdata->size, pdev->name)) {
189 ret = -EBUSY;
190 goto out;
192 pdata->baseaddr = res->start;
193 ioaddr = ioremap(pdata->baseaddr, pdata->size);
194 if (!ioaddr) {
195 ret = -ENOMEM;
196 goto out;
198 pdata->ioaddr_nvram = ioaddr;
199 pdata->size_nvram = pdata->size - RTC_SIZE;
200 pdata->ioaddr_rtc = ioaddr + pdata->size_nvram;
202 /* turn RTC on if it was not on */
203 ioaddr = pdata->ioaddr_rtc;
204 sec = readb(ioaddr + RTC_SECONDS);
205 if (sec & RTC_STOP) {
206 sec &= RTC_SECONDS_MASK;
207 cen = readb(ioaddr + RTC_CENTURY) & RTC_CENTURY_MASK;
208 writeb(RTC_WRITE, ioaddr + RTC_CONTROL);
209 writeb(sec, ioaddr + RTC_SECONDS);
210 writeb(cen & RTC_CENTURY_MASK, ioaddr + RTC_CONTROL);
212 if (!(readb(ioaddr + RTC_DAY) & RTC_BATT_FLAG))
213 dev_warn(&pdev->dev, "voltage-low detected.\n");
215 rtc = rtc_device_register(pdev->name, &pdev->dev,
216 &ds1742_rtc_ops, THIS_MODULE);
217 if (IS_ERR(rtc)) {
218 ret = PTR_ERR(rtc);
219 goto out;
221 pdata->rtc = rtc;
222 pdata->last_jiffies = jiffies;
223 platform_set_drvdata(pdev, pdata);
224 ds1742_nvram_attr.size = max(ds1742_nvram_attr.size,
225 pdata->size_nvram);
226 ret = sysfs_create_bin_file(&pdev->dev.kobj, &ds1742_nvram_attr);
227 if (ret)
228 goto out;
229 return 0;
230 out:
231 if (pdata->rtc)
232 rtc_device_unregister(pdata->rtc);
233 if (pdata->ioaddr_nvram)
234 iounmap(pdata->ioaddr_nvram);
235 if (pdata->baseaddr)
236 release_mem_region(pdata->baseaddr, pdata->size);
237 kfree(pdata);
238 return ret;
241 static int __devexit ds1742_rtc_remove(struct platform_device *pdev)
243 struct rtc_plat_data *pdata = platform_get_drvdata(pdev);
245 sysfs_remove_bin_file(&pdev->dev.kobj, &ds1742_nvram_attr);
246 rtc_device_unregister(pdata->rtc);
247 iounmap(pdata->ioaddr_nvram);
248 release_mem_region(pdata->baseaddr, pdata->size);
249 kfree(pdata);
250 return 0;
253 static struct platform_driver ds1742_rtc_driver = {
254 .probe = ds1742_rtc_probe,
255 .remove = __devexit_p(ds1742_rtc_remove),
256 .driver = {
257 .name = "rtc-ds1742",
258 .owner = THIS_MODULE,
262 static __init int ds1742_init(void)
264 return platform_driver_register(&ds1742_rtc_driver);
267 static __exit void ds1742_exit(void)
269 platform_driver_unregister(&ds1742_rtc_driver);
272 module_init(ds1742_init);
273 module_exit(ds1742_exit);
275 MODULE_AUTHOR("Atsushi Nemoto <anemo@mba.ocn.ne.jp>");
276 MODULE_DESCRIPTION("Dallas DS1742 RTC driver");
277 MODULE_LICENSE("GPL");
278 MODULE_VERSION(DRV_VERSION);