blob: 486142c2637a05da66da8e1542c9545cb50c4d41 [file] [log] [blame]
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -07001/*
2 * rtc class driver for the Maxim MAX6900 chip
3 *
4 * Author: Dale Farnsworth <dale@farnsworth.org>
5 *
6 * based on previously existing rtc class drivers
7 *
8 * 2007 (c) MontaVista, Software, Inc. This file is licensed under
9 * the terms of the GNU General Public License version 2. This program
10 * is licensed "as is" without any warranty of any kind, whether express
11 * or implied.
12 */
13
14#include <linux/module.h>
15#include <linux/i2c.h>
16#include <linux/bcd.h>
17#include <linux/rtc.h>
18#include <linux/delay.h>
19
Alessandro Zummo6fd5c032008-10-15 22:03:08 -070020#define DRV_VERSION "0.2"
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -070021
22/*
23 * register indices
24 */
Alessandro Zummo6fd5c032008-10-15 22:03:08 -070025#define MAX6900_REG_SC 0 /* seconds 00-59 */
26#define MAX6900_REG_MN 1 /* minutes 00-59 */
27#define MAX6900_REG_HR 2 /* hours 00-23 */
28#define MAX6900_REG_DT 3 /* day of month 00-31 */
29#define MAX6900_REG_MO 4 /* month 01-12 */
30#define MAX6900_REG_DW 5 /* day of week 1-7 */
31#define MAX6900_REG_YR 6 /* year 00-99 */
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -070032#define MAX6900_REG_CT 7 /* control */
Dale Farnsworth8a2601f2007-07-21 04:37:57 -070033 /* register 8 is undocumented */
34#define MAX6900_REG_CENTURY 9 /* century */
35#define MAX6900_REG_LEN 10
36
37#define MAX6900_BURST_LEN 8 /* can burst r/w first 8 regs */
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -070038
39#define MAX6900_REG_CT_WP (1 << 7) /* Write Protect */
40
41/*
42 * register read/write commands
43 */
44#define MAX6900_REG_CONTROL_WRITE 0x8e
Dale Farnsworth8a2601f2007-07-21 04:37:57 -070045#define MAX6900_REG_CENTURY_WRITE 0x92
46#define MAX6900_REG_CENTURY_READ 0x93
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -070047#define MAX6900_REG_RESERVED_READ 0x96
Dale Farnsworth8a2601f2007-07-21 04:37:57 -070048#define MAX6900_REG_BURST_WRITE 0xbe
49#define MAX6900_REG_BURST_READ 0xbf
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -070050
51#define MAX6900_IDLE_TIME_AFTER_WRITE 3 /* specification says 2.5 mS */
52
Alessandro Zummo6fd5c032008-10-15 22:03:08 -070053static struct i2c_driver max6900_driver;
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -070054
55static int max6900_i2c_read_regs(struct i2c_client *client, u8 *buf)
56{
Dale Farnsworth8a2601f2007-07-21 04:37:57 -070057 u8 reg_burst_read[1] = { MAX6900_REG_BURST_READ };
58 u8 reg_century_read[1] = { MAX6900_REG_CENTURY_READ };
59 struct i2c_msg msgs[4] = {
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -070060 {
Alessandro Zummo6fd5c032008-10-15 22:03:08 -070061 .addr = client->addr,
62 .flags = 0, /* write */
63 .len = sizeof(reg_burst_read),
64 .buf = reg_burst_read}
65 ,
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -070066 {
Alessandro Zummo6fd5c032008-10-15 22:03:08 -070067 .addr = client->addr,
68 .flags = I2C_M_RD,
69 .len = MAX6900_BURST_LEN,
70 .buf = buf}
71 ,
Dale Farnsworth8a2601f2007-07-21 04:37:57 -070072 {
Alessandro Zummo6fd5c032008-10-15 22:03:08 -070073 .addr = client->addr,
74 .flags = 0, /* write */
75 .len = sizeof(reg_century_read),
76 .buf = reg_century_read}
77 ,
Dale Farnsworth8a2601f2007-07-21 04:37:57 -070078 {
Alessandro Zummo6fd5c032008-10-15 22:03:08 -070079 .addr = client->addr,
80 .flags = I2C_M_RD,
81 .len = sizeof(buf[MAX6900_REG_CENTURY]),
82 .buf = &buf[MAX6900_REG_CENTURY]
83 }
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -070084 };
85 int rc;
86
87 rc = i2c_transfer(client->adapter, msgs, ARRAY_SIZE(msgs));
88 if (rc != ARRAY_SIZE(msgs)) {
Alessandro Zummo6fd5c032008-10-15 22:03:08 -070089 dev_err(&client->dev, "%s: register read failed\n", __func__);
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -070090 return -EIO;
91 }
92 return 0;
93}
94
95static int max6900_i2c_write_regs(struct i2c_client *client, u8 const *buf)
96{
Dale Farnsworth8a2601f2007-07-21 04:37:57 -070097 u8 i2c_century_buf[1 + 1] = { MAX6900_REG_CENTURY_WRITE };
98 struct i2c_msg century_msgs[1] = {
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -070099 {
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700100 .addr = client->addr,
101 .flags = 0, /* write */
102 .len = sizeof(i2c_century_buf),
103 .buf = i2c_century_buf}
Dale Farnsworth8a2601f2007-07-21 04:37:57 -0700104 };
105 u8 i2c_burst_buf[MAX6900_BURST_LEN + 1] = { MAX6900_REG_BURST_WRITE };
106 struct i2c_msg burst_msgs[1] = {
107 {
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700108 .addr = client->addr,
109 .flags = 0, /* write */
110 .len = sizeof(i2c_burst_buf),
111 .buf = i2c_burst_buf}
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700112 };
113 int rc;
114
Dale Farnsworth8a2601f2007-07-21 04:37:57 -0700115 /*
116 * We have to make separate calls to i2c_transfer because of
117 * the need to delay after each write to the chip. Also,
118 * we write the century byte first, since we set the write-protect
119 * bit as part of the burst write.
120 */
121 i2c_century_buf[1] = buf[MAX6900_REG_CENTURY];
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700122
Dale Farnsworth8a2601f2007-07-21 04:37:57 -0700123 rc = i2c_transfer(client->adapter, century_msgs,
124 ARRAY_SIZE(century_msgs));
125 if (rc != ARRAY_SIZE(century_msgs))
126 goto write_failed;
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700127
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700128 msleep(MAX6900_IDLE_TIME_AFTER_WRITE);
Dale Farnsworth8a2601f2007-07-21 04:37:57 -0700129
130 memcpy(&i2c_burst_buf[1], buf, MAX6900_BURST_LEN);
131
132 rc = i2c_transfer(client->adapter, burst_msgs, ARRAY_SIZE(burst_msgs));
133 if (rc != ARRAY_SIZE(burst_msgs))
134 goto write_failed;
135 msleep(MAX6900_IDLE_TIME_AFTER_WRITE);
136
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700137 return 0;
Dale Farnsworth8a2601f2007-07-21 04:37:57 -0700138
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700139 write_failed:
140 dev_err(&client->dev, "%s: register write failed\n", __func__);
Dale Farnsworth8a2601f2007-07-21 04:37:57 -0700141 return -EIO;
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700142}
143
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700144static int max6900_i2c_read_time(struct i2c_client *client, struct rtc_time *tm)
145{
146 int rc;
147 u8 regs[MAX6900_REG_LEN];
148
149 rc = max6900_i2c_read_regs(client, regs);
150 if (rc < 0)
151 return rc;
152
Adrian Bunkfe20ba72008-10-18 20:28:41 -0700153 tm->tm_sec = bcd2bin(regs[MAX6900_REG_SC]);
154 tm->tm_min = bcd2bin(regs[MAX6900_REG_MN]);
155 tm->tm_hour = bcd2bin(regs[MAX6900_REG_HR] & 0x3f);
156 tm->tm_mday = bcd2bin(regs[MAX6900_REG_DT]);
157 tm->tm_mon = bcd2bin(regs[MAX6900_REG_MO]) - 1;
158 tm->tm_year = bcd2bin(regs[MAX6900_REG_YR]) +
159 bcd2bin(regs[MAX6900_REG_CENTURY]) * 100 - 1900;
160 tm->tm_wday = bcd2bin(regs[MAX6900_REG_DW]);
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700161
Wan ZongShunc814dc12010-08-10 18:02:16 -0700162 return rtc_valid_tm(tm);
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700163}
164
165static int max6900_i2c_clear_write_protect(struct i2c_client *client)
166{
167 int rc;
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700168 rc = i2c_smbus_write_byte_data(client, MAX6900_REG_CONTROL_WRITE, 0);
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700169 if (rc < 0) {
170 dev_err(&client->dev, "%s: control register write failed\n",
Harvey Harrison2a4e2b82008-04-28 02:12:00 -0700171 __func__);
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700172 return -EIO;
173 }
174 return 0;
175}
176
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700177static int
178max6900_i2c_set_time(struct i2c_client *client, struct rtc_time const *tm)
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700179{
180 u8 regs[MAX6900_REG_LEN];
181 int rc;
182
183 rc = max6900_i2c_clear_write_protect(client);
184 if (rc < 0)
185 return rc;
186
Adrian Bunkfe20ba72008-10-18 20:28:41 -0700187 regs[MAX6900_REG_SC] = bin2bcd(tm->tm_sec);
188 regs[MAX6900_REG_MN] = bin2bcd(tm->tm_min);
189 regs[MAX6900_REG_HR] = bin2bcd(tm->tm_hour);
190 regs[MAX6900_REG_DT] = bin2bcd(tm->tm_mday);
191 regs[MAX6900_REG_MO] = bin2bcd(tm->tm_mon + 1);
192 regs[MAX6900_REG_DW] = bin2bcd(tm->tm_wday);
193 regs[MAX6900_REG_YR] = bin2bcd(tm->tm_year % 100);
194 regs[MAX6900_REG_CENTURY] = bin2bcd((tm->tm_year + 1900) / 100);
Dale Farnsworth8a2601f2007-07-21 04:37:57 -0700195 /* set write protect */
196 regs[MAX6900_REG_CT] = MAX6900_REG_CT_WP;
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700197
198 rc = max6900_i2c_write_regs(client, regs);
199 if (rc < 0)
200 return rc;
201
202 return 0;
203}
204
205static int max6900_rtc_read_time(struct device *dev, struct rtc_time *tm)
206{
207 return max6900_i2c_read_time(to_i2c_client(dev), tm);
208}
209
210static int max6900_rtc_set_time(struct device *dev, struct rtc_time *tm)
211{
212 return max6900_i2c_set_time(to_i2c_client(dev), tm);
213}
214
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700215static int max6900_remove(struct i2c_client *client)
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700216{
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700217 struct rtc_device *rtc = i2c_get_clientdata(client);
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700218
219 if (rtc)
220 rtc_device_unregister(rtc);
221
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700222 return 0;
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700223}
224
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700225static const struct rtc_class_ops max6900_rtc_ops = {
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700226 .read_time = max6900_rtc_read_time,
227 .set_time = max6900_rtc_set_time,
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700228};
229
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700230static int
231max6900_probe(struct i2c_client *client, const struct i2c_device_id *id)
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700232{
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700233 struct rtc_device *rtc;
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700234
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700235 if (!i2c_check_functionality(client->adapter, I2C_FUNC_I2C))
236 return -ENODEV;
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700237
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700238 dev_info(&client->dev, "chip found, driver version " DRV_VERSION "\n");
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700239
240 rtc = rtc_device_register(max6900_driver.driver.name,
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700241 &client->dev, &max6900_rtc_ops, THIS_MODULE);
242 if (IS_ERR(rtc))
243 return PTR_ERR(rtc);
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700244
245 i2c_set_clientdata(client, rtc);
246
247 return 0;
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700248}
249
Alessandro Zummofe102c72008-12-09 13:14:11 -0800250static struct i2c_device_id max6900_id[] = {
251 { "max6900", 0 },
252 { }
253};
254
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700255static struct i2c_driver max6900_driver = {
256 .driver = {
257 .name = "rtc-max6900",
258 },
259 .probe = max6900_probe,
260 .remove = max6900_remove,
Alessandro Zummofe102c72008-12-09 13:14:11 -0800261 .id_table = max6900_id,
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700262};
263
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700264static int __init max6900_init(void)
265{
266 return i2c_add_driver(&max6900_driver);
267}
268
269static void __exit max6900_exit(void)
270{
271 i2c_del_driver(&max6900_driver);
272}
273
274MODULE_DESCRIPTION("Maxim MAX6900 RTC driver");
Alessandro Zummo6fd5c032008-10-15 22:03:08 -0700275MODULE_AUTHOR("Dale Farnsworth <dale@farnsworth.org>");
Dale Farnsworthaa5bd7e2007-05-08 00:26:39 -0700276MODULE_LICENSE("GPL");
277MODULE_VERSION(DRV_VERSION);
278
279module_init(max6900_init);
280module_exit(max6900_exit);