rtc-rx8581.c 8.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /*
  3. * An I2C driver for the Epson RX8581 RTC
  4. *
  5. * Author: Martyn Welch <[email protected]>
  6. * Copyright 2008 GE Intelligent Platforms Embedded Systems, Inc.
  7. *
  8. * Based on: rtc-pcf8563.c (An I2C driver for the Philips PCF8563 RTC)
  9. * Copyright 2005-06 Tower Technologies
  10. */
  11. #include <linux/module.h>
  12. #include <linux/i2c.h>
  13. #include <linux/bcd.h>
  14. #include <linux/of.h>
  15. #include <linux/of_device.h>
  16. #include <linux/regmap.h>
  17. #include <linux/rtc.h>
  18. #include <linux/log2.h>
  19. #define RX8581_REG_SC 0x00 /* Second in BCD */
  20. #define RX8581_REG_MN 0x01 /* Minute in BCD */
  21. #define RX8581_REG_HR 0x02 /* Hour in BCD */
  22. #define RX8581_REG_DW 0x03 /* Day of Week */
  23. #define RX8581_REG_DM 0x04 /* Day of Month in BCD */
  24. #define RX8581_REG_MO 0x05 /* Month in BCD */
  25. #define RX8581_REG_YR 0x06 /* Year in BCD */
  26. #define RX8581_REG_RAM 0x07 /* RAM */
  27. #define RX8581_REG_AMN 0x08 /* Alarm Min in BCD*/
  28. #define RX8581_REG_AHR 0x09 /* Alarm Hour in BCD */
  29. #define RX8581_REG_ADM 0x0A
  30. #define RX8581_REG_ADW 0x0A
  31. #define RX8581_REG_TMR0 0x0B
  32. #define RX8581_REG_TMR1 0x0C
  33. #define RX8581_REG_EXT 0x0D /* Extension Register */
  34. #define RX8581_REG_FLAG 0x0E /* Flag Register */
  35. #define RX8581_REG_CTRL 0x0F /* Control Register */
  36. /* Flag Register bit definitions */
  37. #define RX8581_FLAG_UF 0x20 /* Update */
  38. #define RX8581_FLAG_TF 0x10 /* Timer */
  39. #define RX8581_FLAG_AF 0x08 /* Alarm */
  40. #define RX8581_FLAG_VLF 0x02 /* Voltage Low */
  41. /* Control Register bit definitions */
  42. #define RX8581_CTRL_UIE 0x20 /* Update Interrupt Enable */
  43. #define RX8581_CTRL_TIE 0x10 /* Timer Interrupt Enable */
  44. #define RX8581_CTRL_AIE 0x08 /* Alarm Interrupt Enable */
  45. #define RX8581_CTRL_STOP 0x02 /* STOP bit */
  46. #define RX8581_CTRL_RESET 0x01 /* RESET bit */
  47. #define RX8571_USER_RAM 0x10
  48. #define RX8571_NVRAM_SIZE 0x10
  49. struct rx8581 {
  50. struct regmap *regmap;
  51. struct rtc_device *rtc;
  52. };
  53. struct rx85x1_config {
  54. struct regmap_config regmap;
  55. unsigned int num_nvram;
  56. };
  57. /*
  58. * In the routines that deal directly with the rx8581 hardware, we use
  59. * rtc_time -- month 0-11, hour 0-23, yr = calendar year-epoch.
  60. */
  61. static int rx8581_rtc_read_time(struct device *dev, struct rtc_time *tm)
  62. {
  63. struct i2c_client *client = to_i2c_client(dev);
  64. unsigned char date[7];
  65. unsigned int data;
  66. int err;
  67. struct rx8581 *rx8581 = i2c_get_clientdata(client);
  68. /* First we ensure that the "update flag" is not set, we read the
  69. * time and date then re-read the "update flag". If the update flag
  70. * has been set, we know that the time has changed during the read so
  71. * we repeat the whole process again.
  72. */
  73. err = regmap_read(rx8581->regmap, RX8581_REG_FLAG, &data);
  74. if (err < 0)
  75. return err;
  76. if (data & RX8581_FLAG_VLF) {
  77. dev_warn(dev,
  78. "low voltage detected, date/time is not reliable.\n");
  79. return -EINVAL;
  80. }
  81. do {
  82. /* If update flag set, clear it */
  83. if (data & RX8581_FLAG_UF) {
  84. err = regmap_write(rx8581->regmap, RX8581_REG_FLAG,
  85. data & ~RX8581_FLAG_UF);
  86. if (err < 0)
  87. return err;
  88. }
  89. /* Now read time and date */
  90. err = regmap_bulk_read(rx8581->regmap, RX8581_REG_SC, date,
  91. sizeof(date));
  92. if (err < 0)
  93. return err;
  94. /* Check flag register */
  95. err = regmap_read(rx8581->regmap, RX8581_REG_FLAG, &data);
  96. if (err < 0)
  97. return err;
  98. } while (data & RX8581_FLAG_UF);
  99. dev_dbg(dev, "%s: raw data is sec=%02x, min=%02x, hr=%02x, "
  100. "wday=%02x, mday=%02x, mon=%02x, year=%02x\n",
  101. __func__,
  102. date[0], date[1], date[2], date[3], date[4], date[5], date[6]);
  103. tm->tm_sec = bcd2bin(date[RX8581_REG_SC] & 0x7F);
  104. tm->tm_min = bcd2bin(date[RX8581_REG_MN] & 0x7F);
  105. tm->tm_hour = bcd2bin(date[RX8581_REG_HR] & 0x3F); /* rtc hr 0-23 */
  106. tm->tm_wday = ilog2(date[RX8581_REG_DW] & 0x7F);
  107. tm->tm_mday = bcd2bin(date[RX8581_REG_DM] & 0x3F);
  108. tm->tm_mon = bcd2bin(date[RX8581_REG_MO] & 0x1F) - 1; /* rtc mn 1-12 */
  109. tm->tm_year = bcd2bin(date[RX8581_REG_YR]) + 100;
  110. dev_dbg(dev, "%s: tm is secs=%d, mins=%d, hours=%d, "
  111. "mday=%d, mon=%d, year=%d, wday=%d\n",
  112. __func__,
  113. tm->tm_sec, tm->tm_min, tm->tm_hour,
  114. tm->tm_mday, tm->tm_mon, tm->tm_year, tm->tm_wday);
  115. return 0;
  116. }
  117. static int rx8581_rtc_set_time(struct device *dev, struct rtc_time *tm)
  118. {
  119. struct i2c_client *client = to_i2c_client(dev);
  120. int err;
  121. unsigned char buf[7];
  122. struct rx8581 *rx8581 = i2c_get_clientdata(client);
  123. dev_dbg(dev, "%s: secs=%d, mins=%d, hours=%d, "
  124. "mday=%d, mon=%d, year=%d, wday=%d\n",
  125. __func__,
  126. tm->tm_sec, tm->tm_min, tm->tm_hour,
  127. tm->tm_mday, tm->tm_mon, tm->tm_year, tm->tm_wday);
  128. /* hours, minutes and seconds */
  129. buf[RX8581_REG_SC] = bin2bcd(tm->tm_sec);
  130. buf[RX8581_REG_MN] = bin2bcd(tm->tm_min);
  131. buf[RX8581_REG_HR] = bin2bcd(tm->tm_hour);
  132. buf[RX8581_REG_DM] = bin2bcd(tm->tm_mday);
  133. /* month, 1 - 12 */
  134. buf[RX8581_REG_MO] = bin2bcd(tm->tm_mon + 1);
  135. /* year and century */
  136. buf[RX8581_REG_YR] = bin2bcd(tm->tm_year - 100);
  137. buf[RX8581_REG_DW] = (0x1 << tm->tm_wday);
  138. /* Stop the clock */
  139. err = regmap_update_bits(rx8581->regmap, RX8581_REG_CTRL,
  140. RX8581_CTRL_STOP, RX8581_CTRL_STOP);
  141. if (err < 0)
  142. return err;
  143. /* write register's data */
  144. err = regmap_bulk_write(rx8581->regmap, RX8581_REG_SC,
  145. buf, sizeof(buf));
  146. if (err < 0)
  147. return err;
  148. /* get VLF and clear it */
  149. err = regmap_update_bits(rx8581->regmap, RX8581_REG_FLAG,
  150. RX8581_FLAG_VLF, 0);
  151. if (err < 0)
  152. return err;
  153. /* Restart the clock */
  154. return regmap_update_bits(rx8581->regmap, RX8581_REG_CTRL,
  155. RX8581_CTRL_STOP, 0);
  156. }
  157. static const struct rtc_class_ops rx8581_rtc_ops = {
  158. .read_time = rx8581_rtc_read_time,
  159. .set_time = rx8581_rtc_set_time,
  160. };
  161. static int rx8571_nvram_read(void *priv, unsigned int offset, void *val,
  162. size_t bytes)
  163. {
  164. struct rx8581 *rx8581 = priv;
  165. return regmap_bulk_read(rx8581->regmap, RX8571_USER_RAM + offset,
  166. val, bytes);
  167. }
  168. static int rx8571_nvram_write(void *priv, unsigned int offset, void *val,
  169. size_t bytes)
  170. {
  171. struct rx8581 *rx8581 = priv;
  172. return regmap_bulk_write(rx8581->regmap, RX8571_USER_RAM + offset,
  173. val, bytes);
  174. }
  175. static int rx85x1_nvram_read(void *priv, unsigned int offset, void *val,
  176. size_t bytes)
  177. {
  178. struct rx8581 *rx8581 = priv;
  179. unsigned int tmp_val;
  180. int ret;
  181. ret = regmap_read(rx8581->regmap, RX8581_REG_RAM, &tmp_val);
  182. (*(unsigned char *)val) = (unsigned char) tmp_val;
  183. return ret;
  184. }
  185. static int rx85x1_nvram_write(void *priv, unsigned int offset, void *val,
  186. size_t bytes)
  187. {
  188. struct rx8581 *rx8581 = priv;
  189. unsigned char tmp_val;
  190. tmp_val = *((unsigned char *)val);
  191. return regmap_write(rx8581->regmap, RX8581_REG_RAM,
  192. (unsigned int)tmp_val);
  193. }
  194. static const struct rx85x1_config rx8581_config = {
  195. .regmap = {
  196. .reg_bits = 8,
  197. .val_bits = 8,
  198. .max_register = 0xf,
  199. },
  200. .num_nvram = 1
  201. };
  202. static const struct rx85x1_config rx8571_config = {
  203. .regmap = {
  204. .reg_bits = 8,
  205. .val_bits = 8,
  206. .max_register = 0x1f,
  207. },
  208. .num_nvram = 2
  209. };
  210. static int rx8581_probe(struct i2c_client *client)
  211. {
  212. struct rx8581 *rx8581;
  213. const struct rx85x1_config *config = &rx8581_config;
  214. const void *data = of_device_get_match_data(&client->dev);
  215. static struct nvmem_config nvmem_cfg[] = {
  216. {
  217. .name = "rx85x1-",
  218. .word_size = 1,
  219. .stride = 1,
  220. .size = 1,
  221. .reg_read = rx85x1_nvram_read,
  222. .reg_write = rx85x1_nvram_write,
  223. }, {
  224. .name = "rx8571-",
  225. .word_size = 1,
  226. .stride = 1,
  227. .size = RX8571_NVRAM_SIZE,
  228. .reg_read = rx8571_nvram_read,
  229. .reg_write = rx8571_nvram_write,
  230. },
  231. };
  232. int ret, i;
  233. dev_dbg(&client->dev, "%s\n", __func__);
  234. if (data)
  235. config = data;
  236. rx8581 = devm_kzalloc(&client->dev, sizeof(struct rx8581), GFP_KERNEL);
  237. if (!rx8581)
  238. return -ENOMEM;
  239. i2c_set_clientdata(client, rx8581);
  240. rx8581->regmap = devm_regmap_init_i2c(client, &config->regmap);
  241. if (IS_ERR(rx8581->regmap))
  242. return PTR_ERR(rx8581->regmap);
  243. rx8581->rtc = devm_rtc_allocate_device(&client->dev);
  244. if (IS_ERR(rx8581->rtc))
  245. return PTR_ERR(rx8581->rtc);
  246. rx8581->rtc->ops = &rx8581_rtc_ops;
  247. rx8581->rtc->range_min = RTC_TIMESTAMP_BEGIN_2000;
  248. rx8581->rtc->range_max = RTC_TIMESTAMP_END_2099;
  249. rx8581->rtc->start_secs = 0;
  250. rx8581->rtc->set_start_time = true;
  251. ret = devm_rtc_register_device(rx8581->rtc);
  252. for (i = 0; i < config->num_nvram; i++) {
  253. nvmem_cfg[i].priv = rx8581;
  254. devm_rtc_nvmem_register(rx8581->rtc, &nvmem_cfg[i]);
  255. }
  256. return ret;
  257. }
  258. static const struct i2c_device_id rx8581_id[] = {
  259. { "rx8581", 0 },
  260. { }
  261. };
  262. MODULE_DEVICE_TABLE(i2c, rx8581_id);
  263. static const __maybe_unused struct of_device_id rx8581_of_match[] = {
  264. { .compatible = "epson,rx8571", .data = &rx8571_config },
  265. { .compatible = "epson,rx8581", .data = &rx8581_config },
  266. { /* sentinel */ }
  267. };
  268. MODULE_DEVICE_TABLE(of, rx8581_of_match);
  269. static struct i2c_driver rx8581_driver = {
  270. .driver = {
  271. .name = "rtc-rx8581",
  272. .of_match_table = of_match_ptr(rx8581_of_match),
  273. },
  274. .probe_new = rx8581_probe,
  275. .id_table = rx8581_id,
  276. };
  277. module_i2c_driver(rx8581_driver);
  278. MODULE_AUTHOR("Martyn Welch <[email protected]>");
  279. MODULE_DESCRIPTION("Epson RX-8571/RX-8581 RTC driver");
  280. MODULE_LICENSE("GPL");