rtc-pcf2127.c 26 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /*
  3. * An I2C and SPI driver for the NXP PCF2127/29 RTC
  4. * Copyright 2013 Til-Technologies
  5. *
  6. * Author: Renaud Cerrato <[email protected]>
  7. *
  8. * Watchdog and tamper functions
  9. * Author: Bruno Thomsen <[email protected]>
  10. *
  11. * based on the other drivers in this same directory.
  12. *
  13. * Datasheet: https://www.nxp.com/docs/en/data-sheet/PCF2127.pdf
  14. */
  15. #include <linux/i2c.h>
  16. #include <linux/spi/spi.h>
  17. #include <linux/bcd.h>
  18. #include <linux/rtc.h>
  19. #include <linux/slab.h>
  20. #include <linux/module.h>
  21. #include <linux/of.h>
  22. #include <linux/of_irq.h>
  23. #include <linux/regmap.h>
  24. #include <linux/watchdog.h>
  25. /* Control register 1 */
  26. #define PCF2127_REG_CTRL1 0x00
  27. #define PCF2127_BIT_CTRL1_POR_OVRD BIT(3)
  28. #define PCF2127_BIT_CTRL1_TSF1 BIT(4)
  29. /* Control register 2 */
  30. #define PCF2127_REG_CTRL2 0x01
  31. #define PCF2127_BIT_CTRL2_AIE BIT(1)
  32. #define PCF2127_BIT_CTRL2_TSIE BIT(2)
  33. #define PCF2127_BIT_CTRL2_AF BIT(4)
  34. #define PCF2127_BIT_CTRL2_TSF2 BIT(5)
  35. #define PCF2127_BIT_CTRL2_WDTF BIT(6)
  36. /* Control register 3 */
  37. #define PCF2127_REG_CTRL3 0x02
  38. #define PCF2127_BIT_CTRL3_BLIE BIT(0)
  39. #define PCF2127_BIT_CTRL3_BIE BIT(1)
  40. #define PCF2127_BIT_CTRL3_BLF BIT(2)
  41. #define PCF2127_BIT_CTRL3_BF BIT(3)
  42. #define PCF2127_BIT_CTRL3_BTSE BIT(4)
  43. /* Time and date registers */
  44. #define PCF2127_REG_SC 0x03
  45. #define PCF2127_BIT_SC_OSF BIT(7)
  46. #define PCF2127_REG_MN 0x04
  47. #define PCF2127_REG_HR 0x05
  48. #define PCF2127_REG_DM 0x06
  49. #define PCF2127_REG_DW 0x07
  50. #define PCF2127_REG_MO 0x08
  51. #define PCF2127_REG_YR 0x09
  52. /* Alarm registers */
  53. #define PCF2127_REG_ALARM_SC 0x0A
  54. #define PCF2127_REG_ALARM_MN 0x0B
  55. #define PCF2127_REG_ALARM_HR 0x0C
  56. #define PCF2127_REG_ALARM_DM 0x0D
  57. #define PCF2127_REG_ALARM_DW 0x0E
  58. #define PCF2127_BIT_ALARM_AE BIT(7)
  59. /* CLKOUT control register */
  60. #define PCF2127_REG_CLKOUT 0x0f
  61. #define PCF2127_BIT_CLKOUT_OTPR BIT(5)
  62. /* Watchdog registers */
  63. #define PCF2127_REG_WD_CTL 0x10
  64. #define PCF2127_BIT_WD_CTL_TF0 BIT(0)
  65. #define PCF2127_BIT_WD_CTL_TF1 BIT(1)
  66. #define PCF2127_BIT_WD_CTL_CD0 BIT(6)
  67. #define PCF2127_BIT_WD_CTL_CD1 BIT(7)
  68. #define PCF2127_REG_WD_VAL 0x11
  69. /* Tamper timestamp registers */
  70. #define PCF2127_REG_TS_CTRL 0x12
  71. #define PCF2127_BIT_TS_CTRL_TSOFF BIT(6)
  72. #define PCF2127_BIT_TS_CTRL_TSM BIT(7)
  73. #define PCF2127_REG_TS_SC 0x13
  74. #define PCF2127_REG_TS_MN 0x14
  75. #define PCF2127_REG_TS_HR 0x15
  76. #define PCF2127_REG_TS_DM 0x16
  77. #define PCF2127_REG_TS_MO 0x17
  78. #define PCF2127_REG_TS_YR 0x18
  79. /*
  80. * RAM registers
  81. * PCF2127 has 512 bytes general-purpose static RAM (SRAM) that is
  82. * battery backed and can survive a power outage.
  83. * PCF2129 doesn't have this feature.
  84. */
  85. #define PCF2127_REG_RAM_ADDR_MSB 0x1A
  86. #define PCF2127_REG_RAM_WRT_CMD 0x1C
  87. #define PCF2127_REG_RAM_RD_CMD 0x1D
  88. /* Watchdog timer value constants */
  89. #define PCF2127_WD_VAL_STOP 0
  90. #define PCF2127_WD_VAL_MIN 2
  91. #define PCF2127_WD_VAL_MAX 255
  92. #define PCF2127_WD_VAL_DEFAULT 60
  93. /* Mask for currently enabled interrupts */
  94. #define PCF2127_CTRL1_IRQ_MASK (PCF2127_BIT_CTRL1_TSF1)
  95. #define PCF2127_CTRL2_IRQ_MASK ( \
  96. PCF2127_BIT_CTRL2_AF | \
  97. PCF2127_BIT_CTRL2_WDTF | \
  98. PCF2127_BIT_CTRL2_TSF2)
  99. struct pcf2127 {
  100. struct rtc_device *rtc;
  101. struct watchdog_device wdd;
  102. struct regmap *regmap;
  103. time64_t ts;
  104. bool ts_valid;
  105. bool irq_enabled;
  106. };
  107. /*
  108. * In the routines that deal directly with the pcf2127 hardware, we use
  109. * rtc_time -- month 0-11, hour 0-23, yr = calendar year-epoch.
  110. */
  111. static int pcf2127_rtc_read_time(struct device *dev, struct rtc_time *tm)
  112. {
  113. struct pcf2127 *pcf2127 = dev_get_drvdata(dev);
  114. unsigned char buf[10];
  115. int ret;
  116. /*
  117. * Avoid reading CTRL2 register as it causes WD_VAL register
  118. * value to reset to 0 which means watchdog is stopped.
  119. */
  120. ret = regmap_bulk_read(pcf2127->regmap, PCF2127_REG_CTRL3,
  121. (buf + PCF2127_REG_CTRL3),
  122. ARRAY_SIZE(buf) - PCF2127_REG_CTRL3);
  123. if (ret) {
  124. dev_err(dev, "%s: read error\n", __func__);
  125. return ret;
  126. }
  127. if (buf[PCF2127_REG_CTRL3] & PCF2127_BIT_CTRL3_BLF)
  128. dev_info(dev,
  129. "low voltage detected, check/replace RTC battery.\n");
  130. /* Clock integrity is not guaranteed when OSF flag is set. */
  131. if (buf[PCF2127_REG_SC] & PCF2127_BIT_SC_OSF) {
  132. /*
  133. * no need clear the flag here,
  134. * it will be cleared once the new date is saved
  135. */
  136. dev_warn(dev,
  137. "oscillator stop detected, date/time is not reliable\n");
  138. return -EINVAL;
  139. }
  140. dev_dbg(dev,
  141. "%s: raw data is cr3=%02x, sec=%02x, min=%02x, hr=%02x, "
  142. "mday=%02x, wday=%02x, mon=%02x, year=%02x\n",
  143. __func__, buf[PCF2127_REG_CTRL3], buf[PCF2127_REG_SC],
  144. buf[PCF2127_REG_MN], buf[PCF2127_REG_HR],
  145. buf[PCF2127_REG_DM], buf[PCF2127_REG_DW],
  146. buf[PCF2127_REG_MO], buf[PCF2127_REG_YR]);
  147. tm->tm_sec = bcd2bin(buf[PCF2127_REG_SC] & 0x7F);
  148. tm->tm_min = bcd2bin(buf[PCF2127_REG_MN] & 0x7F);
  149. tm->tm_hour = bcd2bin(buf[PCF2127_REG_HR] & 0x3F); /* rtc hr 0-23 */
  150. tm->tm_mday = bcd2bin(buf[PCF2127_REG_DM] & 0x3F);
  151. tm->tm_wday = buf[PCF2127_REG_DW] & 0x07;
  152. tm->tm_mon = bcd2bin(buf[PCF2127_REG_MO] & 0x1F) - 1; /* rtc mn 1-12 */
  153. tm->tm_year = bcd2bin(buf[PCF2127_REG_YR]);
  154. tm->tm_year += 100;
  155. dev_dbg(dev, "%s: tm is secs=%d, mins=%d, hours=%d, "
  156. "mday=%d, mon=%d, year=%d, wday=%d\n",
  157. __func__,
  158. tm->tm_sec, tm->tm_min, tm->tm_hour,
  159. tm->tm_mday, tm->tm_mon, tm->tm_year, tm->tm_wday);
  160. return 0;
  161. }
  162. static int pcf2127_rtc_set_time(struct device *dev, struct rtc_time *tm)
  163. {
  164. struct pcf2127 *pcf2127 = dev_get_drvdata(dev);
  165. unsigned char buf[7];
  166. int i = 0, err;
  167. dev_dbg(dev, "%s: secs=%d, mins=%d, hours=%d, "
  168. "mday=%d, mon=%d, year=%d, wday=%d\n",
  169. __func__,
  170. tm->tm_sec, tm->tm_min, tm->tm_hour,
  171. tm->tm_mday, tm->tm_mon, tm->tm_year, tm->tm_wday);
  172. /* hours, minutes and seconds */
  173. buf[i++] = bin2bcd(tm->tm_sec); /* this will also clear OSF flag */
  174. buf[i++] = bin2bcd(tm->tm_min);
  175. buf[i++] = bin2bcd(tm->tm_hour);
  176. buf[i++] = bin2bcd(tm->tm_mday);
  177. buf[i++] = tm->tm_wday & 0x07;
  178. /* month, 1 - 12 */
  179. buf[i++] = bin2bcd(tm->tm_mon + 1);
  180. /* year */
  181. buf[i++] = bin2bcd(tm->tm_year - 100);
  182. /* write register's data */
  183. err = regmap_bulk_write(pcf2127->regmap, PCF2127_REG_SC, buf, i);
  184. if (err) {
  185. dev_err(dev,
  186. "%s: err=%d", __func__, err);
  187. return err;
  188. }
  189. return 0;
  190. }
  191. static int pcf2127_rtc_ioctl(struct device *dev,
  192. unsigned int cmd, unsigned long arg)
  193. {
  194. struct pcf2127 *pcf2127 = dev_get_drvdata(dev);
  195. int val, touser = 0;
  196. int ret;
  197. switch (cmd) {
  198. case RTC_VL_READ:
  199. ret = regmap_read(pcf2127->regmap, PCF2127_REG_CTRL3, &val);
  200. if (ret)
  201. return ret;
  202. if (val & PCF2127_BIT_CTRL3_BLF)
  203. touser |= RTC_VL_BACKUP_LOW;
  204. if (val & PCF2127_BIT_CTRL3_BF)
  205. touser |= RTC_VL_BACKUP_SWITCH;
  206. return put_user(touser, (unsigned int __user *)arg);
  207. case RTC_VL_CLR:
  208. return regmap_update_bits(pcf2127->regmap, PCF2127_REG_CTRL3,
  209. PCF2127_BIT_CTRL3_BF, 0);
  210. default:
  211. return -ENOIOCTLCMD;
  212. }
  213. }
  214. static int pcf2127_nvmem_read(void *priv, unsigned int offset,
  215. void *val, size_t bytes)
  216. {
  217. struct pcf2127 *pcf2127 = priv;
  218. int ret;
  219. unsigned char offsetbuf[] = { offset >> 8, offset };
  220. ret = regmap_bulk_write(pcf2127->regmap, PCF2127_REG_RAM_ADDR_MSB,
  221. offsetbuf, 2);
  222. if (ret)
  223. return ret;
  224. return regmap_bulk_read(pcf2127->regmap, PCF2127_REG_RAM_RD_CMD,
  225. val, bytes);
  226. }
  227. static int pcf2127_nvmem_write(void *priv, unsigned int offset,
  228. void *val, size_t bytes)
  229. {
  230. struct pcf2127 *pcf2127 = priv;
  231. int ret;
  232. unsigned char offsetbuf[] = { offset >> 8, offset };
  233. ret = regmap_bulk_write(pcf2127->regmap, PCF2127_REG_RAM_ADDR_MSB,
  234. offsetbuf, 2);
  235. if (ret)
  236. return ret;
  237. return regmap_bulk_write(pcf2127->regmap, PCF2127_REG_RAM_WRT_CMD,
  238. val, bytes);
  239. }
  240. /* watchdog driver */
  241. static int pcf2127_wdt_ping(struct watchdog_device *wdd)
  242. {
  243. struct pcf2127 *pcf2127 = watchdog_get_drvdata(wdd);
  244. return regmap_write(pcf2127->regmap, PCF2127_REG_WD_VAL, wdd->timeout);
  245. }
  246. /*
  247. * Restart watchdog timer if feature is active.
  248. *
  249. * Note: Reading CTRL2 register causes watchdog to stop which is unfortunate,
  250. * since register also contain control/status flags for other features.
  251. * Always call this function after reading CTRL2 register.
  252. */
  253. static int pcf2127_wdt_active_ping(struct watchdog_device *wdd)
  254. {
  255. int ret = 0;
  256. if (watchdog_active(wdd)) {
  257. ret = pcf2127_wdt_ping(wdd);
  258. if (ret)
  259. dev_err(wdd->parent,
  260. "%s: watchdog restart failed, ret=%d\n",
  261. __func__, ret);
  262. }
  263. return ret;
  264. }
  265. static int pcf2127_wdt_start(struct watchdog_device *wdd)
  266. {
  267. return pcf2127_wdt_ping(wdd);
  268. }
  269. static int pcf2127_wdt_stop(struct watchdog_device *wdd)
  270. {
  271. struct pcf2127 *pcf2127 = watchdog_get_drvdata(wdd);
  272. return regmap_write(pcf2127->regmap, PCF2127_REG_WD_VAL,
  273. PCF2127_WD_VAL_STOP);
  274. }
  275. static int pcf2127_wdt_set_timeout(struct watchdog_device *wdd,
  276. unsigned int new_timeout)
  277. {
  278. dev_dbg(wdd->parent, "new watchdog timeout: %is (old: %is)\n",
  279. new_timeout, wdd->timeout);
  280. wdd->timeout = new_timeout;
  281. return pcf2127_wdt_active_ping(wdd);
  282. }
  283. static const struct watchdog_info pcf2127_wdt_info = {
  284. .identity = "NXP PCF2127/PCF2129 Watchdog",
  285. .options = WDIOF_KEEPALIVEPING | WDIOF_SETTIMEOUT,
  286. };
  287. static const struct watchdog_ops pcf2127_watchdog_ops = {
  288. .owner = THIS_MODULE,
  289. .start = pcf2127_wdt_start,
  290. .stop = pcf2127_wdt_stop,
  291. .ping = pcf2127_wdt_ping,
  292. .set_timeout = pcf2127_wdt_set_timeout,
  293. };
  294. static int pcf2127_watchdog_init(struct device *dev, struct pcf2127 *pcf2127)
  295. {
  296. u32 wdd_timeout;
  297. int ret;
  298. if (!IS_ENABLED(CONFIG_WATCHDOG) ||
  299. !device_property_read_bool(dev, "reset-source"))
  300. return 0;
  301. pcf2127->wdd.parent = dev;
  302. pcf2127->wdd.info = &pcf2127_wdt_info;
  303. pcf2127->wdd.ops = &pcf2127_watchdog_ops;
  304. pcf2127->wdd.min_timeout = PCF2127_WD_VAL_MIN;
  305. pcf2127->wdd.max_timeout = PCF2127_WD_VAL_MAX;
  306. pcf2127->wdd.timeout = PCF2127_WD_VAL_DEFAULT;
  307. pcf2127->wdd.min_hw_heartbeat_ms = 500;
  308. pcf2127->wdd.status = WATCHDOG_NOWAYOUT_INIT_STATUS;
  309. watchdog_set_drvdata(&pcf2127->wdd, pcf2127);
  310. /* Test if watchdog timer is started by bootloader */
  311. ret = regmap_read(pcf2127->regmap, PCF2127_REG_WD_VAL, &wdd_timeout);
  312. if (ret)
  313. return ret;
  314. if (wdd_timeout)
  315. set_bit(WDOG_HW_RUNNING, &pcf2127->wdd.status);
  316. return devm_watchdog_register_device(dev, &pcf2127->wdd);
  317. }
  318. /* Alarm */
  319. static int pcf2127_rtc_read_alarm(struct device *dev, struct rtc_wkalrm *alrm)
  320. {
  321. struct pcf2127 *pcf2127 = dev_get_drvdata(dev);
  322. u8 buf[5];
  323. unsigned int ctrl2;
  324. int ret;
  325. ret = regmap_read(pcf2127->regmap, PCF2127_REG_CTRL2, &ctrl2);
  326. if (ret)
  327. return ret;
  328. ret = pcf2127_wdt_active_ping(&pcf2127->wdd);
  329. if (ret)
  330. return ret;
  331. ret = regmap_bulk_read(pcf2127->regmap, PCF2127_REG_ALARM_SC, buf,
  332. sizeof(buf));
  333. if (ret)
  334. return ret;
  335. alrm->enabled = ctrl2 & PCF2127_BIT_CTRL2_AIE;
  336. alrm->pending = ctrl2 & PCF2127_BIT_CTRL2_AF;
  337. alrm->time.tm_sec = bcd2bin(buf[0] & 0x7F);
  338. alrm->time.tm_min = bcd2bin(buf[1] & 0x7F);
  339. alrm->time.tm_hour = bcd2bin(buf[2] & 0x3F);
  340. alrm->time.tm_mday = bcd2bin(buf[3] & 0x3F);
  341. return 0;
  342. }
  343. static int pcf2127_rtc_alarm_irq_enable(struct device *dev, u32 enable)
  344. {
  345. struct pcf2127 *pcf2127 = dev_get_drvdata(dev);
  346. int ret;
  347. ret = regmap_update_bits(pcf2127->regmap, PCF2127_REG_CTRL2,
  348. PCF2127_BIT_CTRL2_AIE,
  349. enable ? PCF2127_BIT_CTRL2_AIE : 0);
  350. if (ret)
  351. return ret;
  352. return pcf2127_wdt_active_ping(&pcf2127->wdd);
  353. }
  354. static int pcf2127_rtc_set_alarm(struct device *dev, struct rtc_wkalrm *alrm)
  355. {
  356. struct pcf2127 *pcf2127 = dev_get_drvdata(dev);
  357. uint8_t buf[5];
  358. int ret;
  359. ret = regmap_update_bits(pcf2127->regmap, PCF2127_REG_CTRL2,
  360. PCF2127_BIT_CTRL2_AF, 0);
  361. if (ret)
  362. return ret;
  363. ret = pcf2127_wdt_active_ping(&pcf2127->wdd);
  364. if (ret)
  365. return ret;
  366. buf[0] = bin2bcd(alrm->time.tm_sec);
  367. buf[1] = bin2bcd(alrm->time.tm_min);
  368. buf[2] = bin2bcd(alrm->time.tm_hour);
  369. buf[3] = bin2bcd(alrm->time.tm_mday);
  370. buf[4] = PCF2127_BIT_ALARM_AE; /* Do not match on week day */
  371. ret = regmap_bulk_write(pcf2127->regmap, PCF2127_REG_ALARM_SC, buf,
  372. sizeof(buf));
  373. if (ret)
  374. return ret;
  375. return pcf2127_rtc_alarm_irq_enable(dev, alrm->enabled);
  376. }
  377. /*
  378. * This function reads ctrl2 register, caller is responsible for calling
  379. * pcf2127_wdt_active_ping()
  380. */
  381. static int pcf2127_rtc_ts_read(struct device *dev, time64_t *ts)
  382. {
  383. struct pcf2127 *pcf2127 = dev_get_drvdata(dev);
  384. struct rtc_time tm;
  385. int ret;
  386. unsigned char data[25];
  387. ret = regmap_bulk_read(pcf2127->regmap, PCF2127_REG_CTRL1, data,
  388. sizeof(data));
  389. if (ret) {
  390. dev_err(dev, "%s: read error ret=%d\n", __func__, ret);
  391. return ret;
  392. }
  393. dev_dbg(dev,
  394. "%s: raw data is cr1=%02x, cr2=%02x, cr3=%02x, ts_sc=%02x, ts_mn=%02x, ts_hr=%02x, ts_dm=%02x, ts_mo=%02x, ts_yr=%02x\n",
  395. __func__, data[PCF2127_REG_CTRL1], data[PCF2127_REG_CTRL2],
  396. data[PCF2127_REG_CTRL3], data[PCF2127_REG_TS_SC],
  397. data[PCF2127_REG_TS_MN], data[PCF2127_REG_TS_HR],
  398. data[PCF2127_REG_TS_DM], data[PCF2127_REG_TS_MO],
  399. data[PCF2127_REG_TS_YR]);
  400. tm.tm_sec = bcd2bin(data[PCF2127_REG_TS_SC] & 0x7F);
  401. tm.tm_min = bcd2bin(data[PCF2127_REG_TS_MN] & 0x7F);
  402. tm.tm_hour = bcd2bin(data[PCF2127_REG_TS_HR] & 0x3F);
  403. tm.tm_mday = bcd2bin(data[PCF2127_REG_TS_DM] & 0x3F);
  404. /* TS_MO register (month) value range: 1-12 */
  405. tm.tm_mon = bcd2bin(data[PCF2127_REG_TS_MO] & 0x1F) - 1;
  406. tm.tm_year = bcd2bin(data[PCF2127_REG_TS_YR]);
  407. if (tm.tm_year < 70)
  408. tm.tm_year += 100; /* assume we are in 1970...2069 */
  409. ret = rtc_valid_tm(&tm);
  410. if (ret) {
  411. dev_err(dev, "Invalid timestamp. ret=%d\n", ret);
  412. return ret;
  413. }
  414. *ts = rtc_tm_to_time64(&tm);
  415. return 0;
  416. };
  417. static void pcf2127_rtc_ts_snapshot(struct device *dev)
  418. {
  419. struct pcf2127 *pcf2127 = dev_get_drvdata(dev);
  420. int ret;
  421. /* Let userspace read the first timestamp */
  422. if (pcf2127->ts_valid)
  423. return;
  424. ret = pcf2127_rtc_ts_read(dev, &pcf2127->ts);
  425. if (!ret)
  426. pcf2127->ts_valid = true;
  427. }
  428. static irqreturn_t pcf2127_rtc_irq(int irq, void *dev)
  429. {
  430. struct pcf2127 *pcf2127 = dev_get_drvdata(dev);
  431. unsigned int ctrl1, ctrl2;
  432. int ret = 0;
  433. ret = regmap_read(pcf2127->regmap, PCF2127_REG_CTRL1, &ctrl1);
  434. if (ret)
  435. return IRQ_NONE;
  436. ret = regmap_read(pcf2127->regmap, PCF2127_REG_CTRL2, &ctrl2);
  437. if (ret)
  438. return IRQ_NONE;
  439. if (!(ctrl1 & PCF2127_CTRL1_IRQ_MASK || ctrl2 & PCF2127_CTRL2_IRQ_MASK))
  440. return IRQ_NONE;
  441. if (ctrl1 & PCF2127_BIT_CTRL1_TSF1 || ctrl2 & PCF2127_BIT_CTRL2_TSF2)
  442. pcf2127_rtc_ts_snapshot(dev);
  443. if (ctrl1 & PCF2127_CTRL1_IRQ_MASK)
  444. regmap_write(pcf2127->regmap, PCF2127_REG_CTRL1,
  445. ctrl1 & ~PCF2127_CTRL1_IRQ_MASK);
  446. if (ctrl2 & PCF2127_CTRL2_IRQ_MASK)
  447. regmap_write(pcf2127->regmap, PCF2127_REG_CTRL2,
  448. ctrl2 & ~PCF2127_CTRL2_IRQ_MASK);
  449. if (ctrl2 & PCF2127_BIT_CTRL2_AF)
  450. rtc_update_irq(pcf2127->rtc, 1, RTC_IRQF | RTC_AF);
  451. pcf2127_wdt_active_ping(&pcf2127->wdd);
  452. return IRQ_HANDLED;
  453. }
  454. static const struct rtc_class_ops pcf2127_rtc_ops = {
  455. .ioctl = pcf2127_rtc_ioctl,
  456. .read_time = pcf2127_rtc_read_time,
  457. .set_time = pcf2127_rtc_set_time,
  458. .read_alarm = pcf2127_rtc_read_alarm,
  459. .set_alarm = pcf2127_rtc_set_alarm,
  460. .alarm_irq_enable = pcf2127_rtc_alarm_irq_enable,
  461. };
  462. /* sysfs interface */
  463. static ssize_t timestamp0_store(struct device *dev,
  464. struct device_attribute *attr,
  465. const char *buf, size_t count)
  466. {
  467. struct pcf2127 *pcf2127 = dev_get_drvdata(dev->parent);
  468. int ret;
  469. if (pcf2127->irq_enabled) {
  470. pcf2127->ts_valid = false;
  471. } else {
  472. ret = regmap_update_bits(pcf2127->regmap, PCF2127_REG_CTRL1,
  473. PCF2127_BIT_CTRL1_TSF1, 0);
  474. if (ret) {
  475. dev_err(dev, "%s: update ctrl1 ret=%d\n", __func__, ret);
  476. return ret;
  477. }
  478. ret = regmap_update_bits(pcf2127->regmap, PCF2127_REG_CTRL2,
  479. PCF2127_BIT_CTRL2_TSF2, 0);
  480. if (ret) {
  481. dev_err(dev, "%s: update ctrl2 ret=%d\n", __func__, ret);
  482. return ret;
  483. }
  484. ret = pcf2127_wdt_active_ping(&pcf2127->wdd);
  485. if (ret)
  486. return ret;
  487. }
  488. return count;
  489. };
  490. static ssize_t timestamp0_show(struct device *dev,
  491. struct device_attribute *attr, char *buf)
  492. {
  493. struct pcf2127 *pcf2127 = dev_get_drvdata(dev->parent);
  494. unsigned int ctrl1, ctrl2;
  495. int ret;
  496. time64_t ts;
  497. if (pcf2127->irq_enabled) {
  498. if (!pcf2127->ts_valid)
  499. return 0;
  500. ts = pcf2127->ts;
  501. } else {
  502. ret = regmap_read(pcf2127->regmap, PCF2127_REG_CTRL1, &ctrl1);
  503. if (ret)
  504. return 0;
  505. ret = regmap_read(pcf2127->regmap, PCF2127_REG_CTRL2, &ctrl2);
  506. if (ret)
  507. return 0;
  508. if (!(ctrl1 & PCF2127_BIT_CTRL1_TSF1) &&
  509. !(ctrl2 & PCF2127_BIT_CTRL2_TSF2))
  510. return 0;
  511. ret = pcf2127_rtc_ts_read(dev->parent, &ts);
  512. if (ret)
  513. return 0;
  514. ret = pcf2127_wdt_active_ping(&pcf2127->wdd);
  515. if (ret)
  516. return ret;
  517. }
  518. return sprintf(buf, "%llu\n", (unsigned long long)ts);
  519. };
  520. static DEVICE_ATTR_RW(timestamp0);
  521. static struct attribute *pcf2127_attrs[] = {
  522. &dev_attr_timestamp0.attr,
  523. NULL
  524. };
  525. static const struct attribute_group pcf2127_attr_group = {
  526. .attrs = pcf2127_attrs,
  527. };
  528. static int pcf2127_probe(struct device *dev, struct regmap *regmap,
  529. int alarm_irq, const char *name, bool is_pcf2127)
  530. {
  531. struct pcf2127 *pcf2127;
  532. int ret = 0;
  533. unsigned int val;
  534. dev_dbg(dev, "%s\n", __func__);
  535. pcf2127 = devm_kzalloc(dev, sizeof(*pcf2127), GFP_KERNEL);
  536. if (!pcf2127)
  537. return -ENOMEM;
  538. pcf2127->regmap = regmap;
  539. dev_set_drvdata(dev, pcf2127);
  540. pcf2127->rtc = devm_rtc_allocate_device(dev);
  541. if (IS_ERR(pcf2127->rtc))
  542. return PTR_ERR(pcf2127->rtc);
  543. pcf2127->rtc->ops = &pcf2127_rtc_ops;
  544. pcf2127->rtc->range_min = RTC_TIMESTAMP_BEGIN_2000;
  545. pcf2127->rtc->range_max = RTC_TIMESTAMP_END_2099;
  546. pcf2127->rtc->set_start_time = true; /* Sets actual start to 1970 */
  547. set_bit(RTC_FEATURE_ALARM_RES_2S, pcf2127->rtc->features);
  548. clear_bit(RTC_FEATURE_UPDATE_INTERRUPT, pcf2127->rtc->features);
  549. clear_bit(RTC_FEATURE_ALARM, pcf2127->rtc->features);
  550. if (alarm_irq > 0) {
  551. unsigned long flags;
  552. /*
  553. * If flags = 0, devm_request_threaded_irq() will use IRQ flags
  554. * obtained from device tree.
  555. */
  556. if (dev_fwnode(dev))
  557. flags = 0;
  558. else
  559. flags = IRQF_TRIGGER_LOW;
  560. ret = devm_request_threaded_irq(dev, alarm_irq, NULL,
  561. pcf2127_rtc_irq,
  562. flags | IRQF_ONESHOT,
  563. dev_name(dev), dev);
  564. if (ret) {
  565. dev_err(dev, "failed to request alarm irq\n");
  566. return ret;
  567. }
  568. pcf2127->irq_enabled = true;
  569. }
  570. if (alarm_irq > 0 || device_property_read_bool(dev, "wakeup-source")) {
  571. device_init_wakeup(dev, true);
  572. set_bit(RTC_FEATURE_ALARM, pcf2127->rtc->features);
  573. }
  574. if (is_pcf2127) {
  575. struct nvmem_config nvmem_cfg = {
  576. .priv = pcf2127,
  577. .reg_read = pcf2127_nvmem_read,
  578. .reg_write = pcf2127_nvmem_write,
  579. .size = 512,
  580. };
  581. ret = devm_rtc_nvmem_register(pcf2127->rtc, &nvmem_cfg);
  582. }
  583. /*
  584. * The "Power-On Reset Override" facility prevents the RTC to do a reset
  585. * after power on. For normal operation the PORO must be disabled.
  586. */
  587. regmap_clear_bits(pcf2127->regmap, PCF2127_REG_CTRL1,
  588. PCF2127_BIT_CTRL1_POR_OVRD);
  589. ret = regmap_read(pcf2127->regmap, PCF2127_REG_CLKOUT, &val);
  590. if (ret < 0)
  591. return ret;
  592. if (!(val & PCF2127_BIT_CLKOUT_OTPR)) {
  593. ret = regmap_set_bits(pcf2127->regmap, PCF2127_REG_CLKOUT,
  594. PCF2127_BIT_CLKOUT_OTPR);
  595. if (ret < 0)
  596. return ret;
  597. msleep(100);
  598. }
  599. /*
  600. * Watchdog timer enabled and reset pin /RST activated when timed out.
  601. * Select 1Hz clock source for watchdog timer.
  602. * Note: Countdown timer disabled and not available.
  603. * For pca2129, pcf2129, only bit[7] is for Symbol WD_CD
  604. * of register watchdg_tim_ctl. The bit[6] is labeled
  605. * as T. Bits labeled as T must always be written with
  606. * logic 0.
  607. */
  608. ret = regmap_update_bits(pcf2127->regmap, PCF2127_REG_WD_CTL,
  609. PCF2127_BIT_WD_CTL_CD1 |
  610. PCF2127_BIT_WD_CTL_CD0 |
  611. PCF2127_BIT_WD_CTL_TF1 |
  612. PCF2127_BIT_WD_CTL_TF0,
  613. PCF2127_BIT_WD_CTL_CD1 |
  614. (is_pcf2127 ? PCF2127_BIT_WD_CTL_CD0 : 0) |
  615. PCF2127_BIT_WD_CTL_TF1);
  616. if (ret) {
  617. dev_err(dev, "%s: watchdog config (wd_ctl) failed\n", __func__);
  618. return ret;
  619. }
  620. pcf2127_watchdog_init(dev, pcf2127);
  621. /*
  622. * Disable battery low/switch-over timestamp and interrupts.
  623. * Clear battery interrupt flags which can block new trigger events.
  624. * Note: This is the default chip behaviour but added to ensure
  625. * correct tamper timestamp and interrupt function.
  626. */
  627. ret = regmap_update_bits(pcf2127->regmap, PCF2127_REG_CTRL3,
  628. PCF2127_BIT_CTRL3_BTSE |
  629. PCF2127_BIT_CTRL3_BIE |
  630. PCF2127_BIT_CTRL3_BLIE, 0);
  631. if (ret) {
  632. dev_err(dev, "%s: interrupt config (ctrl3) failed\n",
  633. __func__);
  634. return ret;
  635. }
  636. /*
  637. * Enable timestamp function and store timestamp of first trigger
  638. * event until TSF1 and TSF2 interrupt flags are cleared.
  639. */
  640. ret = regmap_update_bits(pcf2127->regmap, PCF2127_REG_TS_CTRL,
  641. PCF2127_BIT_TS_CTRL_TSOFF |
  642. PCF2127_BIT_TS_CTRL_TSM,
  643. PCF2127_BIT_TS_CTRL_TSM);
  644. if (ret) {
  645. dev_err(dev, "%s: tamper detection config (ts_ctrl) failed\n",
  646. __func__);
  647. return ret;
  648. }
  649. /*
  650. * Enable interrupt generation when TSF1 or TSF2 timestamp flags
  651. * are set. Interrupt signal is an open-drain output and can be
  652. * left floating if unused.
  653. */
  654. ret = regmap_update_bits(pcf2127->regmap, PCF2127_REG_CTRL2,
  655. PCF2127_BIT_CTRL2_TSIE,
  656. PCF2127_BIT_CTRL2_TSIE);
  657. if (ret) {
  658. dev_err(dev, "%s: tamper detection config (ctrl2) failed\n",
  659. __func__);
  660. return ret;
  661. }
  662. ret = rtc_add_group(pcf2127->rtc, &pcf2127_attr_group);
  663. if (ret) {
  664. dev_err(dev, "%s: tamper sysfs registering failed\n",
  665. __func__);
  666. return ret;
  667. }
  668. return devm_rtc_register_device(pcf2127->rtc);
  669. }
  670. #ifdef CONFIG_OF
  671. static const struct of_device_id pcf2127_of_match[] = {
  672. { .compatible = "nxp,pcf2127" },
  673. { .compatible = "nxp,pcf2129" },
  674. { .compatible = "nxp,pca2129" },
  675. {}
  676. };
  677. MODULE_DEVICE_TABLE(of, pcf2127_of_match);
  678. #endif
  679. #if IS_ENABLED(CONFIG_I2C)
  680. static int pcf2127_i2c_write(void *context, const void *data, size_t count)
  681. {
  682. struct device *dev = context;
  683. struct i2c_client *client = to_i2c_client(dev);
  684. int ret;
  685. ret = i2c_master_send(client, data, count);
  686. if (ret != count)
  687. return ret < 0 ? ret : -EIO;
  688. return 0;
  689. }
  690. static int pcf2127_i2c_gather_write(void *context,
  691. const void *reg, size_t reg_size,
  692. const void *val, size_t val_size)
  693. {
  694. struct device *dev = context;
  695. struct i2c_client *client = to_i2c_client(dev);
  696. int ret;
  697. void *buf;
  698. if (WARN_ON(reg_size != 1))
  699. return -EINVAL;
  700. buf = kmalloc(val_size + 1, GFP_KERNEL);
  701. if (!buf)
  702. return -ENOMEM;
  703. memcpy(buf, reg, 1);
  704. memcpy(buf + 1, val, val_size);
  705. ret = i2c_master_send(client, buf, val_size + 1);
  706. kfree(buf);
  707. if (ret != val_size + 1)
  708. return ret < 0 ? ret : -EIO;
  709. return 0;
  710. }
  711. static int pcf2127_i2c_read(void *context, const void *reg, size_t reg_size,
  712. void *val, size_t val_size)
  713. {
  714. struct device *dev = context;
  715. struct i2c_client *client = to_i2c_client(dev);
  716. int ret;
  717. if (WARN_ON(reg_size != 1))
  718. return -EINVAL;
  719. ret = i2c_master_send(client, reg, 1);
  720. if (ret != 1)
  721. return ret < 0 ? ret : -EIO;
  722. ret = i2c_master_recv(client, val, val_size);
  723. if (ret != val_size)
  724. return ret < 0 ? ret : -EIO;
  725. return 0;
  726. }
  727. /*
  728. * The reason we need this custom regmap_bus instead of using regmap_init_i2c()
  729. * is that the STOP condition is required between set register address and
  730. * read register data when reading from registers.
  731. */
  732. static const struct regmap_bus pcf2127_i2c_regmap = {
  733. .write = pcf2127_i2c_write,
  734. .gather_write = pcf2127_i2c_gather_write,
  735. .read = pcf2127_i2c_read,
  736. };
  737. static struct i2c_driver pcf2127_i2c_driver;
  738. static const struct i2c_device_id pcf2127_i2c_id[] = {
  739. { "pcf2127", 1 },
  740. { "pcf2129", 0 },
  741. { "pca2129", 0 },
  742. { }
  743. };
  744. MODULE_DEVICE_TABLE(i2c, pcf2127_i2c_id);
  745. static int pcf2127_i2c_probe(struct i2c_client *client)
  746. {
  747. const struct i2c_device_id *id = i2c_match_id(pcf2127_i2c_id, client);
  748. struct regmap *regmap;
  749. static const struct regmap_config config = {
  750. .reg_bits = 8,
  751. .val_bits = 8,
  752. .max_register = 0x1d,
  753. };
  754. if (!i2c_check_functionality(client->adapter, I2C_FUNC_I2C))
  755. return -ENODEV;
  756. regmap = devm_regmap_init(&client->dev, &pcf2127_i2c_regmap,
  757. &client->dev, &config);
  758. if (IS_ERR(regmap)) {
  759. dev_err(&client->dev, "%s: regmap allocation failed: %ld\n",
  760. __func__, PTR_ERR(regmap));
  761. return PTR_ERR(regmap);
  762. }
  763. return pcf2127_probe(&client->dev, regmap, client->irq,
  764. pcf2127_i2c_driver.driver.name, id->driver_data);
  765. }
  766. static struct i2c_driver pcf2127_i2c_driver = {
  767. .driver = {
  768. .name = "rtc-pcf2127-i2c",
  769. .of_match_table = of_match_ptr(pcf2127_of_match),
  770. },
  771. .probe_new = pcf2127_i2c_probe,
  772. .id_table = pcf2127_i2c_id,
  773. };
  774. static int pcf2127_i2c_register_driver(void)
  775. {
  776. return i2c_add_driver(&pcf2127_i2c_driver);
  777. }
  778. static void pcf2127_i2c_unregister_driver(void)
  779. {
  780. i2c_del_driver(&pcf2127_i2c_driver);
  781. }
  782. #else
  783. static int pcf2127_i2c_register_driver(void)
  784. {
  785. return 0;
  786. }
  787. static void pcf2127_i2c_unregister_driver(void)
  788. {
  789. }
  790. #endif
  791. #if IS_ENABLED(CONFIG_SPI_MASTER)
  792. static struct spi_driver pcf2127_spi_driver;
  793. static int pcf2127_spi_probe(struct spi_device *spi)
  794. {
  795. static const struct regmap_config config = {
  796. .reg_bits = 8,
  797. .val_bits = 8,
  798. .read_flag_mask = 0xa0,
  799. .write_flag_mask = 0x20,
  800. .max_register = 0x1d,
  801. };
  802. struct regmap *regmap;
  803. regmap = devm_regmap_init_spi(spi, &config);
  804. if (IS_ERR(regmap)) {
  805. dev_err(&spi->dev, "%s: regmap allocation failed: %ld\n",
  806. __func__, PTR_ERR(regmap));
  807. return PTR_ERR(regmap);
  808. }
  809. return pcf2127_probe(&spi->dev, regmap, spi->irq,
  810. pcf2127_spi_driver.driver.name,
  811. spi_get_device_id(spi)->driver_data);
  812. }
  813. static const struct spi_device_id pcf2127_spi_id[] = {
  814. { "pcf2127", 1 },
  815. { "pcf2129", 0 },
  816. { "pca2129", 0 },
  817. { }
  818. };
  819. MODULE_DEVICE_TABLE(spi, pcf2127_spi_id);
  820. static struct spi_driver pcf2127_spi_driver = {
  821. .driver = {
  822. .name = "rtc-pcf2127-spi",
  823. .of_match_table = of_match_ptr(pcf2127_of_match),
  824. },
  825. .probe = pcf2127_spi_probe,
  826. .id_table = pcf2127_spi_id,
  827. };
  828. static int pcf2127_spi_register_driver(void)
  829. {
  830. return spi_register_driver(&pcf2127_spi_driver);
  831. }
  832. static void pcf2127_spi_unregister_driver(void)
  833. {
  834. spi_unregister_driver(&pcf2127_spi_driver);
  835. }
  836. #else
  837. static int pcf2127_spi_register_driver(void)
  838. {
  839. return 0;
  840. }
  841. static void pcf2127_spi_unregister_driver(void)
  842. {
  843. }
  844. #endif
  845. static int __init pcf2127_init(void)
  846. {
  847. int ret;
  848. ret = pcf2127_i2c_register_driver();
  849. if (ret) {
  850. pr_err("Failed to register pcf2127 i2c driver: %d\n", ret);
  851. return ret;
  852. }
  853. ret = pcf2127_spi_register_driver();
  854. if (ret) {
  855. pr_err("Failed to register pcf2127 spi driver: %d\n", ret);
  856. pcf2127_i2c_unregister_driver();
  857. }
  858. return ret;
  859. }
  860. module_init(pcf2127_init)
  861. static void __exit pcf2127_exit(void)
  862. {
  863. pcf2127_spi_unregister_driver();
  864. pcf2127_i2c_unregister_driver();
  865. }
  866. module_exit(pcf2127_exit)
  867. MODULE_AUTHOR("Renaud Cerrato <[email protected]>");
  868. MODULE_DESCRIPTION("NXP PCF2127/29 RTC driver");
  869. MODULE_LICENSE("GPL v2");