Pull esi-support into release branch
[linux-2.6] / drivers / rtc / rtc-max6902.c
1 /* drivers/char/max6902.c
2  *
3  * Copyright (C) 2006 8D Technologies inc.
4  * Copyright (C) 2004 Compulab Ltd.
5  *
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.
9  *
10  * Driver for MAX6902 spi RTC
11  *
12  * Changelog:
13  *
14  * 24-May-2006: Raphael Assenat <raph@8d.com>
15  *                - Major rework
16  *                              Converted to rtc_device and uses the SPI layer.
17  *
18  * ??-???-2005: Someone at Compulab
19  *                - Initial driver creation.
20  */
21
22 #include <linux/config.h>
23 #include <linux/module.h>
24 #include <linux/version.h>
25
26 #include <linux/kernel.h>
27 #include <linux/platform_device.h>
28 #include <linux/init.h>
29 #include <linux/rtc.h>
30 #include <linux/spi/spi.h>
31 #include <linux/bcd.h>
32 #include <linux/delay.h>
33
34 #define MAX6902_REG_SECONDS             0x01
35 #define MAX6902_REG_MINUTES             0x03
36 #define MAX6902_REG_HOURS               0x05
37 #define MAX6902_REG_DATE                0x07
38 #define MAX6902_REG_MONTH               0x09
39 #define MAX6902_REG_DAY                 0x0B
40 #define MAX6902_REG_YEAR                0x0D
41 #define MAX6902_REG_CONTROL             0x0F
42 #define MAX6902_REG_CENTURY             0x13
43
44 #undef MAX6902_DEBUG
45
46 struct max6902 {
47         struct rtc_device *rtc;
48         u8 buf[9]; /* Burst read cmd + 8 registers */
49         u8 tx_buf[2];
50         u8 rx_buf[2];
51 };
52
53 static void max6902_set_reg(struct device *dev, unsigned char address,
54                                 unsigned char data)
55 {
56         struct spi_device *spi = to_spi_device(dev);
57         unsigned char buf[2];
58
59         /* MSB must be '0' to write */
60         buf[0] = address & 0x7f;
61         buf[1] = data;
62
63         spi_write(spi, buf, 2);
64 }
65
66 static int max6902_get_reg(struct device *dev, unsigned char address,
67                                 unsigned char *data)
68 {
69         struct spi_device *spi = to_spi_device(dev);
70         struct max6902 *chip = dev_get_drvdata(dev);
71         struct spi_message message;
72         struct spi_transfer xfer;
73         int status;
74
75         if (!data)
76                 return -EINVAL;
77
78         /* Build our spi message */
79         spi_message_init(&message);
80         memset(&xfer, 0, sizeof(xfer));
81         xfer.len = 2;
82         /* Can tx_buf and rx_buf be equal? The doc in spi.h is not sure... */
83         xfer.tx_buf = chip->tx_buf;
84         xfer.rx_buf = chip->rx_buf;
85
86         /* Set MSB to indicate read */
87         chip->tx_buf[0] = address | 0x80;
88
89         spi_message_add_tail(&xfer, &message);
90
91         /* do the i/o */
92         status = spi_sync(spi, &message);
93         if (status == 0)
94                 status = message.status;
95         else
96                 return status;
97
98         *data = chip->rx_buf[1];
99
100         return status;
101 }
102
103 static int max6902_get_datetime(struct device *dev, struct rtc_time *dt)
104 {
105         unsigned char tmp;
106         int century;
107         int err;
108         struct spi_device *spi = to_spi_device(dev);
109         struct max6902 *chip = dev_get_drvdata(dev);
110         struct spi_message message;
111         struct spi_transfer xfer;
112         int status;
113
114         err = max6902_get_reg(dev, MAX6902_REG_CENTURY, &tmp);
115         if (err)
116                 return err;
117
118         /* build the message */
119         spi_message_init(&message);
120         memset(&xfer, 0, sizeof(xfer));
121         xfer.len = 1 + 7;       /* Burst read command + 7 registers */
122         xfer.tx_buf = chip->buf;
123         xfer.rx_buf = chip->buf;
124         chip->buf[0] = 0xbf;    /* Burst read */
125         spi_message_add_tail(&xfer, &message);
126
127         /* do the i/o */
128         status = spi_sync(spi, &message);
129         if (status == 0)
130                 status = message.status;
131         else
132                 return status;
133
134         /* The chip sends data in this order:
135          * Seconds, Minutes, Hours, Date, Month, Day, Year */
136         dt->tm_sec      = BCD2BIN(chip->buf[1]);
137         dt->tm_min      = BCD2BIN(chip->buf[2]);
138         dt->tm_hour     = BCD2BIN(chip->buf[3]);
139         dt->tm_mday     = BCD2BIN(chip->buf[4]);
140         dt->tm_mon      = BCD2BIN(chip->buf[5] - 1);
141         dt->tm_wday     = BCD2BIN(chip->buf[6]);
142         dt->tm_year = BCD2BIN(chip->buf[7]);
143
144         century = BCD2BIN(tmp) * 100;
145
146         dt->tm_year += century;
147         dt->tm_year -= 1900;
148
149 #ifdef MAX6902_DEBUG
150         printk("\n%s : Read RTC values\n",__FUNCTION__);
151         printk("tm_hour: %i\n",dt->tm_hour);
152         printk("tm_min : %i\n",dt->tm_min);
153         printk("tm_sec : %i\n",dt->tm_sec);
154         printk("tm_year: %i\n",dt->tm_year);
155         printk("tm_mon : %i\n",dt->tm_mon);
156         printk("tm_mday: %i\n",dt->tm_mday);
157         printk("tm_wday: %i\n",dt->tm_wday);
158 #endif
159
160         return 0;
161 }
162
163 static int max6902_set_datetime(struct device *dev, struct rtc_time *dt)
164 {
165         dt->tm_year = dt->tm_year+1900;
166
167 #ifdef MAX6902_DEBUG
168         printk("\n%s : Setting RTC values\n",__FUNCTION__);
169         printk("tm_sec : %i\n",dt->tm_sec);
170         printk("tm_min : %i\n",dt->tm_min);
171         printk("tm_hour: %i\n",dt->tm_hour);
172         printk("tm_mday: %i\n",dt->tm_mday);
173         printk("tm_wday: %i\n",dt->tm_wday);
174         printk("tm_year: %i\n",dt->tm_year);
175 #endif
176
177         /* Remove write protection */
178         max6902_set_reg(dev, 0xF, 0);
179
180         max6902_set_reg(dev, 0x01, BIN2BCD(dt->tm_sec));
181         max6902_set_reg(dev, 0x03, BIN2BCD(dt->tm_min));
182         max6902_set_reg(dev, 0x05, BIN2BCD(dt->tm_hour));
183
184         max6902_set_reg(dev, 0x07, BIN2BCD(dt->tm_mday));
185         max6902_set_reg(dev, 0x09, BIN2BCD(dt->tm_mon+1));
186         max6902_set_reg(dev, 0x0B, BIN2BCD(dt->tm_wday));
187         max6902_set_reg(dev, 0x0D, BIN2BCD(dt->tm_year%100));
188         max6902_set_reg(dev, 0x13, BIN2BCD(dt->tm_year/100));
189
190         /* Compulab used a delay here. However, the datasheet
191          * does not mention a delay being required anywhere... */
192         /* delay(2000); */
193
194         /* Write protect */
195         max6902_set_reg(dev, 0xF, 0x80);
196
197         return 0;
198 }
199
200 static int max6902_read_time(struct device *dev, struct rtc_time *tm)
201 {
202         return max6902_get_datetime(dev, tm);
203 }
204
205 static int max6902_set_time(struct device *dev, struct rtc_time *tm)
206 {
207         return max6902_set_datetime(dev, tm);
208 }
209
210 static struct rtc_class_ops max6902_rtc_ops = {
211         .read_time      = max6902_read_time,
212         .set_time       = max6902_set_time,
213 };
214
215 static int __devinit max6902_probe(struct spi_device *spi)
216 {
217         struct rtc_device *rtc;
218         unsigned char tmp;
219         struct max6902 *chip;
220         int res;
221
222         rtc = rtc_device_register("max6902",
223                                 &spi->dev, &max6902_rtc_ops, THIS_MODULE);
224         if (IS_ERR(rtc))
225                 return PTR_ERR(rtc);
226
227         spi->mode = SPI_MODE_3;
228         spi->bits_per_word = 8;
229         spi_setup(spi);
230
231         chip = kzalloc(sizeof *chip, GFP_KERNEL);
232         if (!chip) {
233                 rtc_device_unregister(rtc);
234                 return -ENOMEM;
235         }
236         chip->rtc = rtc;
237         dev_set_drvdata(&spi->dev, chip);
238
239         res = max6902_get_reg(&spi->dev, MAX6902_REG_SECONDS, &tmp);
240         if (res) {
241                 rtc_device_unregister(rtc);
242                 return res;
243         }
244
245         return 0;
246 }
247
248 static int __devexit max6902_remove(struct spi_device *spi)
249 {
250         struct max6902 *chip = platform_get_drvdata(spi);
251         struct rtc_device *rtc = chip->rtc;
252
253         if (rtc)
254                 rtc_device_unregister(rtc);
255
256         kfree(chip);
257
258         return 0;
259 }
260
261 static struct spi_driver max6902_driver = {
262         .driver = {
263                 .name   = "max6902",
264                 .bus    = &spi_bus_type,
265                 .owner  = THIS_MODULE,
266         },
267         .probe  = max6902_probe,
268         .remove = __devexit_p(max6902_remove),
269 };
270
271 static __init int max6902_init(void)
272 {
273         printk("max6902 spi driver\n");
274         return spi_register_driver(&max6902_driver);
275 }
276 module_init(max6902_init);
277
278 static __exit void max6902_exit(void)
279 {
280         spi_unregister_driver(&max6902_driver);
281 }
282 module_exit(max6902_exit);
283
284 MODULE_DESCRIPTION ("max6902 spi RTC driver");
285 MODULE_AUTHOR ("Raphael Assenat");
286 MODULE_LICENSE ("GPL");