Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1/*
2 * drivers/rtc/rtc-pcf85363.c
3 *
4 * Driver for NXP PCF85363 real-time clock.
5 *
6 * Copyright (C) 2017 Eric Nelson
7 *
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 as
10 * published by the Free Software Foundation.
11 *
12 * Based loosely on rtc-8583 by Russell King, Wolfram Sang and Juergen Beisert
13 */
14#include <linux/module.h>
15#include <linux/i2c.h>
16#include <linux/slab.h>
17#include <linux/rtc.h>
18#include <linux/init.h>
19#include <linux/err.h>
20#include <linux/errno.h>
21#include <linux/bcd.h>
22#include <linux/of.h>
23#include <linux/of_device.h>
24#include <linux/regmap.h>
25
26/*
27 * Date/Time registers
28 */
29#define DT_100THS 0x00
30#define DT_SECS 0x01
31#define DT_MINUTES 0x02
32#define DT_HOURS 0x03
33#define DT_DAYS 0x04
34#define DT_WEEKDAYS 0x05
35#define DT_MONTHS 0x06
36#define DT_YEARS 0x07
37
38/*
39 * Alarm registers
40 */
41#define DT_SECOND_ALM1 0x08
42#define DT_MINUTE_ALM1 0x09
43#define DT_HOUR_ALM1 0x0a
44#define DT_DAY_ALM1 0x0b
45#define DT_MONTH_ALM1 0x0c
46#define DT_MINUTE_ALM2 0x0d
47#define DT_HOUR_ALM2 0x0e
48#define DT_WEEKDAY_ALM2 0x0f
49#define DT_ALARM_EN 0x10
50
51/*
52 * Time stamp registers
53 */
54#define DT_TIMESTAMP1 0x11
55#define DT_TIMESTAMP2 0x17
56#define DT_TIMESTAMP3 0x1d
57#define DT_TS_MODE 0x23
58
59/*
60 * control registers
61 */
62#define CTRL_OFFSET 0x24
63#define CTRL_OSCILLATOR 0x25
64#define CTRL_BATTERY 0x26
65#define CTRL_PIN_IO 0x27
66#define CTRL_FUNCTION 0x28
67#define CTRL_INTA_EN 0x29
68#define CTRL_INTB_EN 0x2a
69#define CTRL_FLAGS 0x2b
70#define CTRL_RAMBYTE 0x2c
71#define CTRL_WDOG 0x2d
72#define CTRL_STOP_EN 0x2e
73#define CTRL_RESETS 0x2f
74#define CTRL_RAM 0x40
75
76#define ALRM_SEC_A1E BIT(0)
77#define ALRM_MIN_A1E BIT(1)
78#define ALRM_HR_A1E BIT(2)
79#define ALRM_DAY_A1E BIT(3)
80#define ALRM_MON_A1E BIT(4)
81#define ALRM_MIN_A2E BIT(5)
82#define ALRM_HR_A2E BIT(6)
83#define ALRM_DAY_A2E BIT(7)
84
85#define INT_WDIE BIT(0)
86#define INT_BSIE BIT(1)
87#define INT_TSRIE BIT(2)
88#define INT_A2IE BIT(3)
89#define INT_A1IE BIT(4)
90#define INT_OIE BIT(5)
91#define INT_PIE BIT(6)
92#define INT_ILP BIT(7)
93
94#define FLAGS_TSR1F BIT(0)
95#define FLAGS_TSR2F BIT(1)
96#define FLAGS_TSR3F BIT(2)
97#define FLAGS_BSF BIT(3)
98#define FLAGS_WDF BIT(4)
99#define FLAGS_A1F BIT(5)
100#define FLAGS_A2F BIT(6)
101#define FLAGS_PIF BIT(7)
102
103#define PIN_IO_INTAPM GENMASK(1, 0)
104#define PIN_IO_INTA_CLK 0
105#define PIN_IO_INTA_BAT 1
106#define PIN_IO_INTA_OUT 2
107#define PIN_IO_INTA_HIZ 3
108
109#define STOP_EN_STOP BIT(0)
110
111#define RESET_CPR 0xa4
112
113#define NVRAM_SIZE 0x40
114
115static struct i2c_driver pcf85363_driver;
116
117struct pcf85363 {
118 struct device *dev;
119 struct rtc_device *rtc;
120 struct regmap *regmap;
121};
122
123struct pcf85x63_config {
124 struct regmap_config regmap;
125 unsigned int num_nvram;
126};
127
128static int pcf85363_rtc_read_time(struct device *dev, struct rtc_time *tm)
129{
130 struct pcf85363 *pcf85363 = dev_get_drvdata(dev);
131 unsigned char buf[DT_YEARS + 1];
132 int ret, len = sizeof(buf);
133
134 /* read the RTC date and time registers all at once */
135 ret = regmap_bulk_read(pcf85363->regmap, DT_100THS, buf, len);
136 if (ret) {
137 dev_err(dev, "%s: error %d\n", __func__, ret);
138 return ret;
139 }
140
141 tm->tm_year = bcd2bin(buf[DT_YEARS]);
142 /* adjust for 1900 base of rtc_time */
143 tm->tm_year += 100;
144
145 tm->tm_wday = buf[DT_WEEKDAYS] & 7;
146 buf[DT_SECS] &= 0x7F;
147 tm->tm_sec = bcd2bin(buf[DT_SECS]);
148 buf[DT_MINUTES] &= 0x7F;
149 tm->tm_min = bcd2bin(buf[DT_MINUTES]);
150 tm->tm_hour = bcd2bin(buf[DT_HOURS]);
151 tm->tm_mday = bcd2bin(buf[DT_DAYS]);
152 tm->tm_mon = bcd2bin(buf[DT_MONTHS]) - 1;
153
154 return 0;
155}
156
157static int pcf85363_rtc_set_time(struct device *dev, struct rtc_time *tm)
158{
159 struct pcf85363 *pcf85363 = dev_get_drvdata(dev);
160 unsigned char tmp[11];
161 unsigned char *buf = &tmp[2];
162 int ret;
163
164 tmp[0] = STOP_EN_STOP;
165 tmp[1] = RESET_CPR;
166
167 buf[DT_100THS] = 0;
168 buf[DT_SECS] = bin2bcd(tm->tm_sec);
169 buf[DT_MINUTES] = bin2bcd(tm->tm_min);
170 buf[DT_HOURS] = bin2bcd(tm->tm_hour);
171 buf[DT_DAYS] = bin2bcd(tm->tm_mday);
172 buf[DT_WEEKDAYS] = tm->tm_wday;
173 buf[DT_MONTHS] = bin2bcd(tm->tm_mon + 1);
174 buf[DT_YEARS] = bin2bcd(tm->tm_year % 100);
175
176 ret = regmap_bulk_write(pcf85363->regmap, CTRL_STOP_EN,
177 tmp, sizeof(tmp));
178 if (ret)
179 return ret;
180
181 return regmap_write(pcf85363->regmap, CTRL_STOP_EN, 0);
182}
183
184static int pcf85363_rtc_read_alarm(struct device *dev, struct rtc_wkalrm *alrm)
185{
186 struct pcf85363 *pcf85363 = dev_get_drvdata(dev);
187 unsigned char buf[DT_MONTH_ALM1 - DT_SECOND_ALM1 + 1];
188 unsigned int val;
189 int ret;
190
191 ret = regmap_bulk_read(pcf85363->regmap, DT_SECOND_ALM1, buf,
192 sizeof(buf));
193 if (ret)
194 return ret;
195
196 alrm->time.tm_sec = bcd2bin(buf[0]);
197 alrm->time.tm_min = bcd2bin(buf[1]);
198 alrm->time.tm_hour = bcd2bin(buf[2]);
199 alrm->time.tm_mday = bcd2bin(buf[3]);
200 alrm->time.tm_mon = bcd2bin(buf[4]) - 1;
201
202 ret = regmap_read(pcf85363->regmap, CTRL_INTA_EN, &val);
203 if (ret)
204 return ret;
205
206 alrm->enabled = !!(val & INT_A1IE);
207
208 return 0;
209}
210
211static int _pcf85363_rtc_alarm_irq_enable(struct pcf85363 *pcf85363, unsigned
212 int enabled)
213{
214 unsigned int alarm_flags = ALRM_SEC_A1E | ALRM_MIN_A1E | ALRM_HR_A1E |
215 ALRM_DAY_A1E | ALRM_MON_A1E;
216 int ret;
217
218 ret = regmap_update_bits(pcf85363->regmap, DT_ALARM_EN, alarm_flags,
219 enabled ? alarm_flags : 0);
220 if (ret)
221 return ret;
222
223 ret = regmap_update_bits(pcf85363->regmap, CTRL_INTA_EN,
224 INT_A1IE, enabled ? INT_A1IE : 0);
225
226 if (ret || enabled)
227 return ret;
228
229 /* clear current flags */
230 return regmap_update_bits(pcf85363->regmap, CTRL_FLAGS, FLAGS_A1F, 0);
231}
232
233static int pcf85363_rtc_alarm_irq_enable(struct device *dev,
234 unsigned int enabled)
235{
236 struct pcf85363 *pcf85363 = dev_get_drvdata(dev);
237
238 return _pcf85363_rtc_alarm_irq_enable(pcf85363, enabled);
239}
240
241static int pcf85363_rtc_set_alarm(struct device *dev, struct rtc_wkalrm *alrm)
242{
243 struct pcf85363 *pcf85363 = dev_get_drvdata(dev);
244 unsigned char buf[DT_MONTH_ALM1 - DT_SECOND_ALM1 + 1];
245 int ret;
246
247 buf[0] = bin2bcd(alrm->time.tm_sec);
248 buf[1] = bin2bcd(alrm->time.tm_min);
249 buf[2] = bin2bcd(alrm->time.tm_hour);
250 buf[3] = bin2bcd(alrm->time.tm_mday);
251 buf[4] = bin2bcd(alrm->time.tm_mon + 1);
252
253 /*
254 * Disable the alarm interrupt before changing the value to avoid
255 * spurious interrupts
256 */
257 ret = _pcf85363_rtc_alarm_irq_enable(pcf85363, 0);
258 if (ret)
259 return ret;
260
261 ret = regmap_bulk_write(pcf85363->regmap, DT_SECOND_ALM1, buf,
262 sizeof(buf));
263 if (ret)
264 return ret;
265
266 return _pcf85363_rtc_alarm_irq_enable(pcf85363, alrm->enabled);
267}
268
269static irqreturn_t pcf85363_rtc_handle_irq(int irq, void *dev_id)
270{
271 struct pcf85363 *pcf85363 = i2c_get_clientdata(dev_id);
272 unsigned int flags;
273 int err;
274
275 err = regmap_read(pcf85363->regmap, CTRL_FLAGS, &flags);
276 if (err)
277 return IRQ_NONE;
278
279 if (flags & FLAGS_A1F) {
280 rtc_update_irq(pcf85363->rtc, 1, RTC_IRQF | RTC_AF);
281 regmap_update_bits(pcf85363->regmap, CTRL_FLAGS, FLAGS_A1F, 0);
282 return IRQ_HANDLED;
283 }
284
285 return IRQ_NONE;
286}
287
288static const struct rtc_class_ops rtc_ops = {
289 .read_time = pcf85363_rtc_read_time,
290 .set_time = pcf85363_rtc_set_time,
291};
292
293static const struct rtc_class_ops rtc_ops_alarm = {
294 .read_time = pcf85363_rtc_read_time,
295 .set_time = pcf85363_rtc_set_time,
296 .read_alarm = pcf85363_rtc_read_alarm,
297 .set_alarm = pcf85363_rtc_set_alarm,
298 .alarm_irq_enable = pcf85363_rtc_alarm_irq_enable,
299};
300
301static int pcf85363_nvram_read(void *priv, unsigned int offset, void *val,
302 size_t bytes)
303{
304 struct pcf85363 *pcf85363 = priv;
305
306 return regmap_bulk_read(pcf85363->regmap, CTRL_RAM + offset,
307 val, bytes);
308}
309
310static int pcf85363_nvram_write(void *priv, unsigned int offset, void *val,
311 size_t bytes)
312{
313 struct pcf85363 *pcf85363 = priv;
314
315 return regmap_bulk_write(pcf85363->regmap, CTRL_RAM + offset,
316 val, bytes);
317}
318
319static int pcf85x63_nvram_read(void *priv, unsigned int offset, void *val,
320 size_t bytes)
321{
322 struct pcf85363 *pcf85363 = priv;
323 unsigned int tmp_val;
324 int ret;
325
326 ret = regmap_read(pcf85363->regmap, CTRL_RAMBYTE, &tmp_val);
327 (*(unsigned char *) val) = (unsigned char) tmp_val;
328
329 return ret;
330}
331
332static int pcf85x63_nvram_write(void *priv, unsigned int offset, void *val,
333 size_t bytes)
334{
335 struct pcf85363 *pcf85363 = priv;
336 unsigned char tmp_val;
337
338 tmp_val = *((unsigned char *)val);
339 return regmap_write(pcf85363->regmap, CTRL_RAMBYTE,
340 (unsigned int)tmp_val);
341}
342
343static const struct pcf85x63_config pcf_85263_config = {
344 .regmap = {
345 .reg_bits = 8,
346 .val_bits = 8,
347 .max_register = 0x2f,
348 },
349 .num_nvram = 1
350};
351
352static const struct pcf85x63_config pcf_85363_config = {
353 .regmap = {
354 .reg_bits = 8,
355 .val_bits = 8,
356 .max_register = 0x7f,
357 },
358 .num_nvram = 2
359};
360
361static int pcf85363_probe(struct i2c_client *client,
362 const struct i2c_device_id *id)
363{
364 struct pcf85363 *pcf85363;
365 const struct pcf85x63_config *config = &pcf_85363_config;
366 const void *data = of_device_get_match_data(&client->dev);
367 static struct nvmem_config nvmem_cfg[] = {
368 {
369 .name = "pcf85x63-",
370 .word_size = 1,
371 .stride = 1,
372 .size = 1,
373 .reg_read = pcf85x63_nvram_read,
374 .reg_write = pcf85x63_nvram_write,
375 }, {
376 .name = "pcf85363-",
377 .word_size = 1,
378 .stride = 1,
379 .size = NVRAM_SIZE,
380 .reg_read = pcf85363_nvram_read,
381 .reg_write = pcf85363_nvram_write,
382 },
383 };
384 int ret, i;
385
386 if (data)
387 config = data;
388
389 if (!i2c_check_functionality(client->adapter, I2C_FUNC_I2C))
390 return -ENODEV;
391
392 pcf85363 = devm_kzalloc(&client->dev, sizeof(struct pcf85363),
393 GFP_KERNEL);
394 if (!pcf85363)
395 return -ENOMEM;
396
397 pcf85363->regmap = devm_regmap_init_i2c(client, &config->regmap);
398 if (IS_ERR(pcf85363->regmap)) {
399 dev_err(&client->dev, "regmap allocation failed\n");
400 return PTR_ERR(pcf85363->regmap);
401 }
402
403 pcf85363->dev = &client->dev;
404 i2c_set_clientdata(client, pcf85363);
405
406 pcf85363->rtc = devm_rtc_allocate_device(pcf85363->dev);
407 if (IS_ERR(pcf85363->rtc))
408 return PTR_ERR(pcf85363->rtc);
409
410 pcf85363->rtc->ops = &rtc_ops;
411
412 if (client->irq > 0) {
413 regmap_write(pcf85363->regmap, CTRL_FLAGS, 0);
414 regmap_update_bits(pcf85363->regmap, CTRL_PIN_IO,
415 PIN_IO_INTA_OUT, PIN_IO_INTAPM);
416 ret = devm_request_threaded_irq(pcf85363->dev, client->irq,
417 NULL, pcf85363_rtc_handle_irq,
418 IRQF_TRIGGER_LOW | IRQF_ONESHOT,
419 "pcf85363", client);
420 if (ret)
421 dev_warn(&client->dev, "unable to request IRQ, alarms disabled\n");
422 else
423 pcf85363->rtc->ops = &rtc_ops_alarm;
424 }
425
426 ret = rtc_register_device(pcf85363->rtc);
427
428 for (i = 0; i < config->num_nvram; i++) {
429 nvmem_cfg[i].priv = pcf85363;
430 rtc_nvmem_register(pcf85363->rtc, &nvmem_cfg[i]);
431 }
432
433 return ret;
434}
435
436static const struct of_device_id dev_ids[] = {
437 { .compatible = "nxp,pcf85263", .data = &pcf_85263_config },
438 { .compatible = "nxp,pcf85363", .data = &pcf_85363_config },
439 { /* sentinel */ }
440};
441MODULE_DEVICE_TABLE(of, dev_ids);
442
443static struct i2c_driver pcf85363_driver = {
444 .driver = {
445 .name = "pcf85363",
446 .of_match_table = of_match_ptr(dev_ids),
447 },
448 .probe = pcf85363_probe,
449};
450
451module_i2c_driver(pcf85363_driver);
452
453MODULE_AUTHOR("Eric Nelson");
454MODULE_DESCRIPTION("pcf85263/pcf85363 I2C RTC driver");
455MODULE_LICENSE("GPL");