rtc-ds1307.c 42 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625
  1. /*
  2. * rtc-ds1307.c - RTC driver for some mostly-compatible I2C chips.
  3. *
  4. * Copyright (C) 2005 James Chapman (ds1337 core)
  5. * Copyright (C) 2006 David Brownell
  6. * Copyright (C) 2009 Matthias Fuchs (rx8025 support)
  7. * Copyright (C) 2012 Bertrand Achard (nvram access fixes)
  8. *
  9. * This program is free software; you can redistribute it and/or modify
  10. * it under the terms of the GNU General Public License version 2 as
  11. * published by the Free Software Foundation.
  12. */
  13. #include <linux/bcd.h>
  14. #include <linux/i2c.h>
  15. #include <linux/init.h>
  16. #include <linux/module.h>
  17. #include <linux/rtc/ds1307.h>
  18. #include <linux/rtc.h>
  19. #include <linux/slab.h>
  20. #include <linux/string.h>
  21. #include <linux/hwmon.h>
  22. #include <linux/hwmon-sysfs.h>
  23. #include <linux/clk-provider.h>
  24. /*
  25. * We can't determine type by probing, but if we expect pre-Linux code
  26. * to have set the chip up as a clock (turning on the oscillator and
  27. * setting the date and time), Linux can ignore the non-clock features.
  28. * That's a natural job for a factory or repair bench.
  29. */
  30. enum ds_type {
  31. ds_1307,
  32. ds_1337,
  33. ds_1338,
  34. ds_1339,
  35. ds_1340,
  36. ds_1388,
  37. ds_3231,
  38. m41t00,
  39. mcp794xx,
  40. rx_8025,
  41. last_ds_type /* always last */
  42. /* rs5c372 too? different address... */
  43. };
  44. /* RTC registers don't differ much, except for the century flag */
  45. #define DS1307_REG_SECS 0x00 /* 00-59 */
  46. # define DS1307_BIT_CH 0x80
  47. # define DS1340_BIT_nEOSC 0x80
  48. # define MCP794XX_BIT_ST 0x80
  49. #define DS1307_REG_MIN 0x01 /* 00-59 */
  50. #define DS1307_REG_HOUR 0x02 /* 00-23, or 1-12{am,pm} */
  51. # define DS1307_BIT_12HR 0x40 /* in REG_HOUR */
  52. # define DS1307_BIT_PM 0x20 /* in REG_HOUR */
  53. # define DS1340_BIT_CENTURY_EN 0x80 /* in REG_HOUR */
  54. # define DS1340_BIT_CENTURY 0x40 /* in REG_HOUR */
  55. #define DS1307_REG_WDAY 0x03 /* 01-07 */
  56. # define MCP794XX_BIT_VBATEN 0x08
  57. #define DS1307_REG_MDAY 0x04 /* 01-31 */
  58. #define DS1307_REG_MONTH 0x05 /* 01-12 */
  59. # define DS1337_BIT_CENTURY 0x80 /* in REG_MONTH */
  60. #define DS1307_REG_YEAR 0x06 /* 00-99 */
  61. /*
  62. * Other registers (control, status, alarms, trickle charge, NVRAM, etc)
  63. * start at 7, and they differ a LOT. Only control and status matter for
  64. * basic RTC date and time functionality; be careful using them.
  65. */
  66. #define DS1307_REG_CONTROL 0x07 /* or ds1338 */
  67. # define DS1307_BIT_OUT 0x80
  68. # define DS1338_BIT_OSF 0x20
  69. # define DS1307_BIT_SQWE 0x10
  70. # define DS1307_BIT_RS1 0x02
  71. # define DS1307_BIT_RS0 0x01
  72. #define DS1337_REG_CONTROL 0x0e
  73. # define DS1337_BIT_nEOSC 0x80
  74. # define DS1339_BIT_BBSQI 0x20
  75. # define DS3231_BIT_BBSQW 0x40 /* same as BBSQI */
  76. # define DS1337_BIT_RS2 0x10
  77. # define DS1337_BIT_RS1 0x08
  78. # define DS1337_BIT_INTCN 0x04
  79. # define DS1337_BIT_A2IE 0x02
  80. # define DS1337_BIT_A1IE 0x01
  81. #define DS1340_REG_CONTROL 0x07
  82. # define DS1340_BIT_OUT 0x80
  83. # define DS1340_BIT_FT 0x40
  84. # define DS1340_BIT_CALIB_SIGN 0x20
  85. # define DS1340_M_CALIBRATION 0x1f
  86. #define DS1340_REG_FLAG 0x09
  87. # define DS1340_BIT_OSF 0x80
  88. #define DS1337_REG_STATUS 0x0f
  89. # define DS1337_BIT_OSF 0x80
  90. # define DS3231_BIT_EN32KHZ 0x08
  91. # define DS1337_BIT_A2I 0x02
  92. # define DS1337_BIT_A1I 0x01
  93. #define DS1339_REG_ALARM1_SECS 0x07
  94. #define DS13XX_TRICKLE_CHARGER_MAGIC 0xa0
  95. #define RX8025_REG_CTRL1 0x0e
  96. # define RX8025_BIT_2412 0x20
  97. #define RX8025_REG_CTRL2 0x0f
  98. # define RX8025_BIT_PON 0x10
  99. # define RX8025_BIT_VDET 0x40
  100. # define RX8025_BIT_XST 0x20
  101. struct ds1307 {
  102. u8 offset; /* register's offset */
  103. u8 regs[11];
  104. u16 nvram_offset;
  105. struct bin_attribute *nvram;
  106. enum ds_type type;
  107. unsigned long flags;
  108. #define HAS_NVRAM 0 /* bit 0 == sysfs file active */
  109. #define HAS_ALARM 1 /* bit 1 == irq claimed */
  110. struct i2c_client *client;
  111. struct rtc_device *rtc;
  112. s32 (*read_block_data)(const struct i2c_client *client, u8 command,
  113. u8 length, u8 *values);
  114. s32 (*write_block_data)(const struct i2c_client *client, u8 command,
  115. u8 length, const u8 *values);
  116. #ifdef CONFIG_COMMON_CLK
  117. struct clk_hw clks[2];
  118. #endif
  119. };
  120. struct chip_desc {
  121. unsigned alarm:1;
  122. u16 nvram_offset;
  123. u16 nvram_size;
  124. u16 trickle_charger_reg;
  125. u8 trickle_charger_setup;
  126. u8 (*do_trickle_setup)(struct i2c_client *, uint32_t, bool);
  127. };
  128. static u8 do_trickle_setup_ds1339(struct i2c_client *,
  129. uint32_t ohms, bool diode);
  130. static struct chip_desc chips[last_ds_type] = {
  131. [ds_1307] = {
  132. .nvram_offset = 8,
  133. .nvram_size = 56,
  134. },
  135. [ds_1337] = {
  136. .alarm = 1,
  137. },
  138. [ds_1338] = {
  139. .nvram_offset = 8,
  140. .nvram_size = 56,
  141. },
  142. [ds_1339] = {
  143. .alarm = 1,
  144. .trickle_charger_reg = 0x10,
  145. .do_trickle_setup = &do_trickle_setup_ds1339,
  146. },
  147. [ds_1340] = {
  148. .trickle_charger_reg = 0x08,
  149. },
  150. [ds_1388] = {
  151. .trickle_charger_reg = 0x0a,
  152. },
  153. [ds_3231] = {
  154. .alarm = 1,
  155. },
  156. [mcp794xx] = {
  157. .alarm = 1,
  158. /* this is battery backed SRAM */
  159. .nvram_offset = 0x20,
  160. .nvram_size = 0x40,
  161. },
  162. };
  163. static const struct i2c_device_id ds1307_id[] = {
  164. { "ds1307", ds_1307 },
  165. { "ds1337", ds_1337 },
  166. { "ds1338", ds_1338 },
  167. { "ds1339", ds_1339 },
  168. { "ds1388", ds_1388 },
  169. { "ds1340", ds_1340 },
  170. { "ds3231", ds_3231 },
  171. { "m41t00", m41t00 },
  172. { "mcp7940x", mcp794xx },
  173. { "mcp7941x", mcp794xx },
  174. { "pt7c4338", ds_1307 },
  175. { "rx8025", rx_8025 },
  176. { }
  177. };
  178. MODULE_DEVICE_TABLE(i2c, ds1307_id);
  179. /*----------------------------------------------------------------------*/
  180. #define BLOCK_DATA_MAX_TRIES 10
  181. static s32 ds1307_read_block_data_once(const struct i2c_client *client,
  182. u8 command, u8 length, u8 *values)
  183. {
  184. s32 i, data;
  185. for (i = 0; i < length; i++) {
  186. data = i2c_smbus_read_byte_data(client, command + i);
  187. if (data < 0)
  188. return data;
  189. values[i] = data;
  190. }
  191. return i;
  192. }
  193. static s32 ds1307_read_block_data(const struct i2c_client *client, u8 command,
  194. u8 length, u8 *values)
  195. {
  196. u8 oldvalues[255];
  197. s32 ret;
  198. int tries = 0;
  199. dev_dbg(&client->dev, "ds1307_read_block_data (length=%d)\n", length);
  200. ret = ds1307_read_block_data_once(client, command, length, values);
  201. if (ret < 0)
  202. return ret;
  203. do {
  204. if (++tries > BLOCK_DATA_MAX_TRIES) {
  205. dev_err(&client->dev,
  206. "ds1307_read_block_data failed\n");
  207. return -EIO;
  208. }
  209. memcpy(oldvalues, values, length);
  210. ret = ds1307_read_block_data_once(client, command, length,
  211. values);
  212. if (ret < 0)
  213. return ret;
  214. } while (memcmp(oldvalues, values, length));
  215. return length;
  216. }
  217. static s32 ds1307_write_block_data(const struct i2c_client *client, u8 command,
  218. u8 length, const u8 *values)
  219. {
  220. u8 currvalues[255];
  221. int tries = 0;
  222. dev_dbg(&client->dev, "ds1307_write_block_data (length=%d)\n", length);
  223. do {
  224. s32 i, ret;
  225. if (++tries > BLOCK_DATA_MAX_TRIES) {
  226. dev_err(&client->dev,
  227. "ds1307_write_block_data failed\n");
  228. return -EIO;
  229. }
  230. for (i = 0; i < length; i++) {
  231. ret = i2c_smbus_write_byte_data(client, command + i,
  232. values[i]);
  233. if (ret < 0)
  234. return ret;
  235. }
  236. ret = ds1307_read_block_data_once(client, command, length,
  237. currvalues);
  238. if (ret < 0)
  239. return ret;
  240. } while (memcmp(currvalues, values, length));
  241. return length;
  242. }
  243. /*----------------------------------------------------------------------*/
  244. /* These RTC devices are not designed to be connected to a SMbus adapter.
  245. SMbus limits block operations length to 32 bytes, whereas it's not
  246. limited on I2C buses. As a result, accesses may exceed 32 bytes;
  247. in that case, split them into smaller blocks */
  248. static s32 ds1307_native_smbus_write_block_data(const struct i2c_client *client,
  249. u8 command, u8 length, const u8 *values)
  250. {
  251. u8 suboffset = 0;
  252. if (length <= I2C_SMBUS_BLOCK_MAX) {
  253. s32 retval = i2c_smbus_write_i2c_block_data(client,
  254. command, length, values);
  255. if (retval < 0)
  256. return retval;
  257. return length;
  258. }
  259. while (suboffset < length) {
  260. s32 retval = i2c_smbus_write_i2c_block_data(client,
  261. command + suboffset,
  262. min(I2C_SMBUS_BLOCK_MAX, length - suboffset),
  263. values + suboffset);
  264. if (retval < 0)
  265. return retval;
  266. suboffset += I2C_SMBUS_BLOCK_MAX;
  267. }
  268. return length;
  269. }
  270. static s32 ds1307_native_smbus_read_block_data(const struct i2c_client *client,
  271. u8 command, u8 length, u8 *values)
  272. {
  273. u8 suboffset = 0;
  274. if (length <= I2C_SMBUS_BLOCK_MAX)
  275. return i2c_smbus_read_i2c_block_data(client,
  276. command, length, values);
  277. while (suboffset < length) {
  278. s32 retval = i2c_smbus_read_i2c_block_data(client,
  279. command + suboffset,
  280. min(I2C_SMBUS_BLOCK_MAX, length - suboffset),
  281. values + suboffset);
  282. if (retval < 0)
  283. return retval;
  284. suboffset += I2C_SMBUS_BLOCK_MAX;
  285. }
  286. return length;
  287. }
  288. /*----------------------------------------------------------------------*/
  289. /*
  290. * The ds1337 and ds1339 both have two alarms, but we only use the first
  291. * one (with a "seconds" field). For ds1337 we expect nINTA is our alarm
  292. * signal; ds1339 chips have only one alarm signal.
  293. */
  294. static irqreturn_t ds1307_irq(int irq, void *dev_id)
  295. {
  296. struct i2c_client *client = dev_id;
  297. struct ds1307 *ds1307 = i2c_get_clientdata(client);
  298. struct mutex *lock = &ds1307->rtc->ops_lock;
  299. int stat, control;
  300. mutex_lock(lock);
  301. stat = i2c_smbus_read_byte_data(client, DS1337_REG_STATUS);
  302. if (stat < 0)
  303. goto out;
  304. if (stat & DS1337_BIT_A1I) {
  305. stat &= ~DS1337_BIT_A1I;
  306. i2c_smbus_write_byte_data(client, DS1337_REG_STATUS, stat);
  307. control = i2c_smbus_read_byte_data(client, DS1337_REG_CONTROL);
  308. if (control < 0)
  309. goto out;
  310. control &= ~DS1337_BIT_A1IE;
  311. i2c_smbus_write_byte_data(client, DS1337_REG_CONTROL, control);
  312. rtc_update_irq(ds1307->rtc, 1, RTC_AF | RTC_IRQF);
  313. }
  314. out:
  315. mutex_unlock(lock);
  316. return IRQ_HANDLED;
  317. }
  318. /*----------------------------------------------------------------------*/
  319. static int ds1307_get_time(struct device *dev, struct rtc_time *t)
  320. {
  321. struct ds1307 *ds1307 = dev_get_drvdata(dev);
  322. int tmp;
  323. /* read the RTC date and time registers all at once */
  324. tmp = ds1307->read_block_data(ds1307->client,
  325. ds1307->offset, 7, ds1307->regs);
  326. if (tmp != 7) {
  327. dev_err(dev, "%s error %d\n", "read", tmp);
  328. return -EIO;
  329. }
  330. dev_dbg(dev, "%s: %7ph\n", "read", ds1307->regs);
  331. t->tm_sec = bcd2bin(ds1307->regs[DS1307_REG_SECS] & 0x7f);
  332. t->tm_min = bcd2bin(ds1307->regs[DS1307_REG_MIN] & 0x7f);
  333. tmp = ds1307->regs[DS1307_REG_HOUR] & 0x3f;
  334. t->tm_hour = bcd2bin(tmp);
  335. t->tm_wday = bcd2bin(ds1307->regs[DS1307_REG_WDAY] & 0x07) - 1;
  336. t->tm_mday = bcd2bin(ds1307->regs[DS1307_REG_MDAY] & 0x3f);
  337. tmp = ds1307->regs[DS1307_REG_MONTH] & 0x1f;
  338. t->tm_mon = bcd2bin(tmp) - 1;
  339. /* assume 20YY not 19YY, and ignore DS1337_BIT_CENTURY */
  340. t->tm_year = bcd2bin(ds1307->regs[DS1307_REG_YEAR]) + 100;
  341. dev_dbg(dev, "%s secs=%d, mins=%d, "
  342. "hours=%d, mday=%d, mon=%d, year=%d, wday=%d\n",
  343. "read", t->tm_sec, t->tm_min,
  344. t->tm_hour, t->tm_mday,
  345. t->tm_mon, t->tm_year, t->tm_wday);
  346. /* initial clock setting can be undefined */
  347. return rtc_valid_tm(t);
  348. }
  349. static int ds1307_set_time(struct device *dev, struct rtc_time *t)
  350. {
  351. struct ds1307 *ds1307 = dev_get_drvdata(dev);
  352. int result;
  353. int tmp;
  354. u8 *buf = ds1307->regs;
  355. dev_dbg(dev, "%s secs=%d, mins=%d, "
  356. "hours=%d, mday=%d, mon=%d, year=%d, wday=%d\n",
  357. "write", t->tm_sec, t->tm_min,
  358. t->tm_hour, t->tm_mday,
  359. t->tm_mon, t->tm_year, t->tm_wday);
  360. buf[DS1307_REG_SECS] = bin2bcd(t->tm_sec);
  361. buf[DS1307_REG_MIN] = bin2bcd(t->tm_min);
  362. buf[DS1307_REG_HOUR] = bin2bcd(t->tm_hour);
  363. buf[DS1307_REG_WDAY] = bin2bcd(t->tm_wday + 1);
  364. buf[DS1307_REG_MDAY] = bin2bcd(t->tm_mday);
  365. buf[DS1307_REG_MONTH] = bin2bcd(t->tm_mon + 1);
  366. /* assume 20YY not 19YY */
  367. tmp = t->tm_year - 100;
  368. buf[DS1307_REG_YEAR] = bin2bcd(tmp);
  369. switch (ds1307->type) {
  370. case ds_1337:
  371. case ds_1339:
  372. case ds_3231:
  373. buf[DS1307_REG_MONTH] |= DS1337_BIT_CENTURY;
  374. break;
  375. case ds_1340:
  376. buf[DS1307_REG_HOUR] |= DS1340_BIT_CENTURY_EN
  377. | DS1340_BIT_CENTURY;
  378. break;
  379. case mcp794xx:
  380. /*
  381. * these bits were cleared when preparing the date/time
  382. * values and need to be set again before writing the
  383. * buffer out to the device.
  384. */
  385. buf[DS1307_REG_SECS] |= MCP794XX_BIT_ST;
  386. buf[DS1307_REG_WDAY] |= MCP794XX_BIT_VBATEN;
  387. break;
  388. default:
  389. break;
  390. }
  391. dev_dbg(dev, "%s: %7ph\n", "write", buf);
  392. result = ds1307->write_block_data(ds1307->client,
  393. ds1307->offset, 7, buf);
  394. if (result < 0) {
  395. dev_err(dev, "%s error %d\n", "write", result);
  396. return result;
  397. }
  398. return 0;
  399. }
  400. static int ds1337_read_alarm(struct device *dev, struct rtc_wkalrm *t)
  401. {
  402. struct i2c_client *client = to_i2c_client(dev);
  403. struct ds1307 *ds1307 = i2c_get_clientdata(client);
  404. int ret;
  405. if (!test_bit(HAS_ALARM, &ds1307->flags))
  406. return -EINVAL;
  407. /* read all ALARM1, ALARM2, and status registers at once */
  408. ret = ds1307->read_block_data(client,
  409. DS1339_REG_ALARM1_SECS, 9, ds1307->regs);
  410. if (ret != 9) {
  411. dev_err(dev, "%s error %d\n", "alarm read", ret);
  412. return -EIO;
  413. }
  414. dev_dbg(dev, "%s: %4ph, %3ph, %2ph\n", "alarm read",
  415. &ds1307->regs[0], &ds1307->regs[4], &ds1307->regs[7]);
  416. /*
  417. * report alarm time (ALARM1); assume 24 hour and day-of-month modes,
  418. * and that all four fields are checked matches
  419. */
  420. t->time.tm_sec = bcd2bin(ds1307->regs[0] & 0x7f);
  421. t->time.tm_min = bcd2bin(ds1307->regs[1] & 0x7f);
  422. t->time.tm_hour = bcd2bin(ds1307->regs[2] & 0x3f);
  423. t->time.tm_mday = bcd2bin(ds1307->regs[3] & 0x3f);
  424. t->time.tm_mon = -1;
  425. t->time.tm_year = -1;
  426. t->time.tm_wday = -1;
  427. t->time.tm_yday = -1;
  428. t->time.tm_isdst = -1;
  429. /* ... and status */
  430. t->enabled = !!(ds1307->regs[7] & DS1337_BIT_A1IE);
  431. t->pending = !!(ds1307->regs[8] & DS1337_BIT_A1I);
  432. dev_dbg(dev, "%s secs=%d, mins=%d, "
  433. "hours=%d, mday=%d, enabled=%d, pending=%d\n",
  434. "alarm read", t->time.tm_sec, t->time.tm_min,
  435. t->time.tm_hour, t->time.tm_mday,
  436. t->enabled, t->pending);
  437. return 0;
  438. }
  439. static int ds1337_set_alarm(struct device *dev, struct rtc_wkalrm *t)
  440. {
  441. struct i2c_client *client = to_i2c_client(dev);
  442. struct ds1307 *ds1307 = i2c_get_clientdata(client);
  443. unsigned char *buf = ds1307->regs;
  444. u8 control, status;
  445. int ret;
  446. if (!test_bit(HAS_ALARM, &ds1307->flags))
  447. return -EINVAL;
  448. dev_dbg(dev, "%s secs=%d, mins=%d, "
  449. "hours=%d, mday=%d, enabled=%d, pending=%d\n",
  450. "alarm set", t->time.tm_sec, t->time.tm_min,
  451. t->time.tm_hour, t->time.tm_mday,
  452. t->enabled, t->pending);
  453. /* read current status of both alarms and the chip */
  454. ret = ds1307->read_block_data(client,
  455. DS1339_REG_ALARM1_SECS, 9, buf);
  456. if (ret != 9) {
  457. dev_err(dev, "%s error %d\n", "alarm write", ret);
  458. return -EIO;
  459. }
  460. control = ds1307->regs[7];
  461. status = ds1307->regs[8];
  462. dev_dbg(dev, "%s: %4ph, %3ph, %02x %02x\n", "alarm set (old status)",
  463. &ds1307->regs[0], &ds1307->regs[4], control, status);
  464. /* set ALARM1, using 24 hour and day-of-month modes */
  465. buf[0] = bin2bcd(t->time.tm_sec);
  466. buf[1] = bin2bcd(t->time.tm_min);
  467. buf[2] = bin2bcd(t->time.tm_hour);
  468. buf[3] = bin2bcd(t->time.tm_mday);
  469. /* set ALARM2 to non-garbage */
  470. buf[4] = 0;
  471. buf[5] = 0;
  472. buf[6] = 0;
  473. /* disable alarms */
  474. buf[7] = control & ~(DS1337_BIT_A1IE | DS1337_BIT_A2IE);
  475. buf[8] = status & ~(DS1337_BIT_A1I | DS1337_BIT_A2I);
  476. ret = ds1307->write_block_data(client,
  477. DS1339_REG_ALARM1_SECS, 9, buf);
  478. if (ret < 0) {
  479. dev_err(dev, "can't set alarm time\n");
  480. return ret;
  481. }
  482. /* optionally enable ALARM1 */
  483. if (t->enabled) {
  484. dev_dbg(dev, "alarm IRQ armed\n");
  485. buf[7] |= DS1337_BIT_A1IE; /* only ALARM1 is used */
  486. i2c_smbus_write_byte_data(client, DS1337_REG_CONTROL, buf[7]);
  487. }
  488. return 0;
  489. }
  490. static int ds1307_alarm_irq_enable(struct device *dev, unsigned int enabled)
  491. {
  492. struct i2c_client *client = to_i2c_client(dev);
  493. struct ds1307 *ds1307 = i2c_get_clientdata(client);
  494. int ret;
  495. if (!test_bit(HAS_ALARM, &ds1307->flags))
  496. return -ENOTTY;
  497. ret = i2c_smbus_read_byte_data(client, DS1337_REG_CONTROL);
  498. if (ret < 0)
  499. return ret;
  500. if (enabled)
  501. ret |= DS1337_BIT_A1IE;
  502. else
  503. ret &= ~DS1337_BIT_A1IE;
  504. ret = i2c_smbus_write_byte_data(client, DS1337_REG_CONTROL, ret);
  505. if (ret < 0)
  506. return ret;
  507. return 0;
  508. }
  509. static const struct rtc_class_ops ds13xx_rtc_ops = {
  510. .read_time = ds1307_get_time,
  511. .set_time = ds1307_set_time,
  512. .read_alarm = ds1337_read_alarm,
  513. .set_alarm = ds1337_set_alarm,
  514. .alarm_irq_enable = ds1307_alarm_irq_enable,
  515. };
  516. /*----------------------------------------------------------------------*/
  517. /*
  518. * Alarm support for mcp794xx devices.
  519. */
  520. #define MCP794XX_REG_CONTROL 0x07
  521. # define MCP794XX_BIT_ALM0_EN 0x10
  522. # define MCP794XX_BIT_ALM1_EN 0x20
  523. #define MCP794XX_REG_ALARM0_BASE 0x0a
  524. #define MCP794XX_REG_ALARM0_CTRL 0x0d
  525. #define MCP794XX_REG_ALARM1_BASE 0x11
  526. #define MCP794XX_REG_ALARM1_CTRL 0x14
  527. # define MCP794XX_BIT_ALMX_IF (1 << 3)
  528. # define MCP794XX_BIT_ALMX_C0 (1 << 4)
  529. # define MCP794XX_BIT_ALMX_C1 (1 << 5)
  530. # define MCP794XX_BIT_ALMX_C2 (1 << 6)
  531. # define MCP794XX_BIT_ALMX_POL (1 << 7)
  532. # define MCP794XX_MSK_ALMX_MATCH (MCP794XX_BIT_ALMX_C0 | \
  533. MCP794XX_BIT_ALMX_C1 | \
  534. MCP794XX_BIT_ALMX_C2)
  535. static irqreturn_t mcp794xx_irq(int irq, void *dev_id)
  536. {
  537. struct i2c_client *client = dev_id;
  538. struct ds1307 *ds1307 = i2c_get_clientdata(client);
  539. struct mutex *lock = &ds1307->rtc->ops_lock;
  540. int reg, ret;
  541. mutex_lock(lock);
  542. /* Check and clear alarm 0 interrupt flag. */
  543. reg = i2c_smbus_read_byte_data(client, MCP794XX_REG_ALARM0_CTRL);
  544. if (reg < 0)
  545. goto out;
  546. if (!(reg & MCP794XX_BIT_ALMX_IF))
  547. goto out;
  548. reg &= ~MCP794XX_BIT_ALMX_IF;
  549. ret = i2c_smbus_write_byte_data(client, MCP794XX_REG_ALARM0_CTRL, reg);
  550. if (ret < 0)
  551. goto out;
  552. /* Disable alarm 0. */
  553. reg = i2c_smbus_read_byte_data(client, MCP794XX_REG_CONTROL);
  554. if (reg < 0)
  555. goto out;
  556. reg &= ~MCP794XX_BIT_ALM0_EN;
  557. ret = i2c_smbus_write_byte_data(client, MCP794XX_REG_CONTROL, reg);
  558. if (ret < 0)
  559. goto out;
  560. rtc_update_irq(ds1307->rtc, 1, RTC_AF | RTC_IRQF);
  561. out:
  562. mutex_unlock(lock);
  563. return IRQ_HANDLED;
  564. }
  565. static int mcp794xx_read_alarm(struct device *dev, struct rtc_wkalrm *t)
  566. {
  567. struct i2c_client *client = to_i2c_client(dev);
  568. struct ds1307 *ds1307 = i2c_get_clientdata(client);
  569. u8 *regs = ds1307->regs;
  570. int ret;
  571. if (!test_bit(HAS_ALARM, &ds1307->flags))
  572. return -EINVAL;
  573. /* Read control and alarm 0 registers. */
  574. ret = ds1307->read_block_data(client, MCP794XX_REG_CONTROL, 10, regs);
  575. if (ret < 0)
  576. return ret;
  577. t->enabled = !!(regs[0] & MCP794XX_BIT_ALM0_EN);
  578. /* Report alarm 0 time assuming 24-hour and day-of-month modes. */
  579. t->time.tm_sec = bcd2bin(ds1307->regs[3] & 0x7f);
  580. t->time.tm_min = bcd2bin(ds1307->regs[4] & 0x7f);
  581. t->time.tm_hour = bcd2bin(ds1307->regs[5] & 0x3f);
  582. t->time.tm_wday = bcd2bin(ds1307->regs[6] & 0x7) - 1;
  583. t->time.tm_mday = bcd2bin(ds1307->regs[7] & 0x3f);
  584. t->time.tm_mon = bcd2bin(ds1307->regs[8] & 0x1f) - 1;
  585. t->time.tm_year = -1;
  586. t->time.tm_yday = -1;
  587. t->time.tm_isdst = -1;
  588. dev_dbg(dev, "%s, sec=%d min=%d hour=%d wday=%d mday=%d mon=%d "
  589. "enabled=%d polarity=%d irq=%d match=%d\n", __func__,
  590. t->time.tm_sec, t->time.tm_min, t->time.tm_hour,
  591. t->time.tm_wday, t->time.tm_mday, t->time.tm_mon, t->enabled,
  592. !!(ds1307->regs[6] & MCP794XX_BIT_ALMX_POL),
  593. !!(ds1307->regs[6] & MCP794XX_BIT_ALMX_IF),
  594. (ds1307->regs[6] & MCP794XX_MSK_ALMX_MATCH) >> 4);
  595. return 0;
  596. }
  597. static int mcp794xx_set_alarm(struct device *dev, struct rtc_wkalrm *t)
  598. {
  599. struct i2c_client *client = to_i2c_client(dev);
  600. struct ds1307 *ds1307 = i2c_get_clientdata(client);
  601. unsigned char *regs = ds1307->regs;
  602. int ret;
  603. if (!test_bit(HAS_ALARM, &ds1307->flags))
  604. return -EINVAL;
  605. dev_dbg(dev, "%s, sec=%d min=%d hour=%d wday=%d mday=%d mon=%d "
  606. "enabled=%d pending=%d\n", __func__,
  607. t->time.tm_sec, t->time.tm_min, t->time.tm_hour,
  608. t->time.tm_wday, t->time.tm_mday, t->time.tm_mon,
  609. t->enabled, t->pending);
  610. /* Read control and alarm 0 registers. */
  611. ret = ds1307->read_block_data(client, MCP794XX_REG_CONTROL, 10, regs);
  612. if (ret < 0)
  613. return ret;
  614. /* Set alarm 0, using 24-hour and day-of-month modes. */
  615. regs[3] = bin2bcd(t->time.tm_sec);
  616. regs[4] = bin2bcd(t->time.tm_min);
  617. regs[5] = bin2bcd(t->time.tm_hour);
  618. regs[6] = bin2bcd(t->time.tm_wday + 1);
  619. regs[7] = bin2bcd(t->time.tm_mday);
  620. regs[8] = bin2bcd(t->time.tm_mon + 1);
  621. /* Clear the alarm 0 interrupt flag. */
  622. regs[6] &= ~MCP794XX_BIT_ALMX_IF;
  623. /* Set alarm match: second, minute, hour, day, date, month. */
  624. regs[6] |= MCP794XX_MSK_ALMX_MATCH;
  625. /* Disable interrupt. We will not enable until completely programmed */
  626. regs[0] &= ~MCP794XX_BIT_ALM0_EN;
  627. ret = ds1307->write_block_data(client, MCP794XX_REG_CONTROL, 10, regs);
  628. if (ret < 0)
  629. return ret;
  630. if (!t->enabled)
  631. return 0;
  632. regs[0] |= MCP794XX_BIT_ALM0_EN;
  633. return i2c_smbus_write_byte_data(client, MCP794XX_REG_CONTROL, regs[0]);
  634. }
  635. static int mcp794xx_alarm_irq_enable(struct device *dev, unsigned int enabled)
  636. {
  637. struct i2c_client *client = to_i2c_client(dev);
  638. struct ds1307 *ds1307 = i2c_get_clientdata(client);
  639. int reg;
  640. if (!test_bit(HAS_ALARM, &ds1307->flags))
  641. return -EINVAL;
  642. reg = i2c_smbus_read_byte_data(client, MCP794XX_REG_CONTROL);
  643. if (reg < 0)
  644. return reg;
  645. if (enabled)
  646. reg |= MCP794XX_BIT_ALM0_EN;
  647. else
  648. reg &= ~MCP794XX_BIT_ALM0_EN;
  649. return i2c_smbus_write_byte_data(client, MCP794XX_REG_CONTROL, reg);
  650. }
  651. static const struct rtc_class_ops mcp794xx_rtc_ops = {
  652. .read_time = ds1307_get_time,
  653. .set_time = ds1307_set_time,
  654. .read_alarm = mcp794xx_read_alarm,
  655. .set_alarm = mcp794xx_set_alarm,
  656. .alarm_irq_enable = mcp794xx_alarm_irq_enable,
  657. };
  658. /*----------------------------------------------------------------------*/
  659. static ssize_t
  660. ds1307_nvram_read(struct file *filp, struct kobject *kobj,
  661. struct bin_attribute *attr,
  662. char *buf, loff_t off, size_t count)
  663. {
  664. struct i2c_client *client;
  665. struct ds1307 *ds1307;
  666. int result;
  667. client = kobj_to_i2c_client(kobj);
  668. ds1307 = i2c_get_clientdata(client);
  669. result = ds1307->read_block_data(client, ds1307->nvram_offset + off,
  670. count, buf);
  671. if (result < 0)
  672. dev_err(&client->dev, "%s error %d\n", "nvram read", result);
  673. return result;
  674. }
  675. static ssize_t
  676. ds1307_nvram_write(struct file *filp, struct kobject *kobj,
  677. struct bin_attribute *attr,
  678. char *buf, loff_t off, size_t count)
  679. {
  680. struct i2c_client *client;
  681. struct ds1307 *ds1307;
  682. int result;
  683. client = kobj_to_i2c_client(kobj);
  684. ds1307 = i2c_get_clientdata(client);
  685. result = ds1307->write_block_data(client, ds1307->nvram_offset + off,
  686. count, buf);
  687. if (result < 0) {
  688. dev_err(&client->dev, "%s error %d\n", "nvram write", result);
  689. return result;
  690. }
  691. return count;
  692. }
  693. /*----------------------------------------------------------------------*/
  694. static u8 do_trickle_setup_ds1339(struct i2c_client *client,
  695. uint32_t ohms, bool diode)
  696. {
  697. u8 setup = (diode) ? DS1307_TRICKLE_CHARGER_DIODE :
  698. DS1307_TRICKLE_CHARGER_NO_DIODE;
  699. switch (ohms) {
  700. case 250:
  701. setup |= DS1307_TRICKLE_CHARGER_250_OHM;
  702. break;
  703. case 2000:
  704. setup |= DS1307_TRICKLE_CHARGER_2K_OHM;
  705. break;
  706. case 4000:
  707. setup |= DS1307_TRICKLE_CHARGER_4K_OHM;
  708. break;
  709. default:
  710. dev_warn(&client->dev,
  711. "Unsupported ohm value %u in dt\n", ohms);
  712. return 0;
  713. }
  714. return setup;
  715. }
  716. static void ds1307_trickle_of_init(struct i2c_client *client,
  717. struct chip_desc *chip)
  718. {
  719. uint32_t ohms = 0;
  720. bool diode = true;
  721. if (!chip->do_trickle_setup)
  722. goto out;
  723. if (of_property_read_u32(client->dev.of_node, "trickle-resistor-ohms" , &ohms))
  724. goto out;
  725. if (of_property_read_bool(client->dev.of_node, "trickle-diode-disable"))
  726. diode = false;
  727. chip->trickle_charger_setup = chip->do_trickle_setup(client,
  728. ohms, diode);
  729. out:
  730. return;
  731. }
  732. /*----------------------------------------------------------------------*/
  733. #ifdef CONFIG_RTC_DRV_DS1307_HWMON
  734. /*
  735. * Temperature sensor support for ds3231 devices.
  736. */
  737. #define DS3231_REG_TEMPERATURE 0x11
  738. /*
  739. * A user-initiated temperature conversion is not started by this function,
  740. * so the temperature is updated once every 64 seconds.
  741. */
  742. static int ds3231_hwmon_read_temp(struct device *dev, s32 *mC)
  743. {
  744. struct ds1307 *ds1307 = dev_get_drvdata(dev);
  745. u8 temp_buf[2];
  746. s16 temp;
  747. int ret;
  748. ret = ds1307->read_block_data(ds1307->client, DS3231_REG_TEMPERATURE,
  749. sizeof(temp_buf), temp_buf);
  750. if (ret < 0)
  751. return ret;
  752. if (ret != sizeof(temp_buf))
  753. return -EIO;
  754. /*
  755. * Temperature is represented as a 10-bit code with a resolution of
  756. * 0.25 degree celsius and encoded in two's complement format.
  757. */
  758. temp = (temp_buf[0] << 8) | temp_buf[1];
  759. temp >>= 6;
  760. *mC = temp * 250;
  761. return 0;
  762. }
  763. static ssize_t ds3231_hwmon_show_temp(struct device *dev,
  764. struct device_attribute *attr, char *buf)
  765. {
  766. int ret;
  767. s32 temp;
  768. ret = ds3231_hwmon_read_temp(dev, &temp);
  769. if (ret)
  770. return ret;
  771. return sprintf(buf, "%d\n", temp);
  772. }
  773. static SENSOR_DEVICE_ATTR(temp1_input, S_IRUGO, ds3231_hwmon_show_temp,
  774. NULL, 0);
  775. static struct attribute *ds3231_hwmon_attrs[] = {
  776. &sensor_dev_attr_temp1_input.dev_attr.attr,
  777. NULL,
  778. };
  779. ATTRIBUTE_GROUPS(ds3231_hwmon);
  780. static void ds1307_hwmon_register(struct ds1307 *ds1307)
  781. {
  782. struct device *dev;
  783. if (ds1307->type != ds_3231)
  784. return;
  785. dev = devm_hwmon_device_register_with_groups(&ds1307->client->dev,
  786. ds1307->client->name,
  787. ds1307, ds3231_hwmon_groups);
  788. if (IS_ERR(dev)) {
  789. dev_warn(&ds1307->client->dev,
  790. "unable to register hwmon device %ld\n", PTR_ERR(dev));
  791. }
  792. }
  793. #else
  794. static void ds1307_hwmon_register(struct ds1307 *ds1307)
  795. {
  796. }
  797. #endif /* CONFIG_RTC_DRV_DS1307_HWMON */
  798. /*----------------------------------------------------------------------*/
  799. /*
  800. * Square-wave output support for DS3231
  801. * Datasheet: https://datasheets.maximintegrated.com/en/ds/DS3231.pdf
  802. */
  803. #ifdef CONFIG_COMMON_CLK
  804. enum {
  805. DS3231_CLK_SQW = 0,
  806. DS3231_CLK_32KHZ,
  807. };
  808. #define clk_sqw_to_ds1307(clk) \
  809. container_of(clk, struct ds1307, clks[DS3231_CLK_SQW])
  810. #define clk_32khz_to_ds1307(clk) \
  811. container_of(clk, struct ds1307, clks[DS3231_CLK_32KHZ])
  812. static int ds3231_clk_sqw_rates[] = {
  813. 1,
  814. 1024,
  815. 4096,
  816. 8192,
  817. };
  818. static int ds1337_write_control(struct ds1307 *ds1307, u8 mask, u8 value)
  819. {
  820. struct i2c_client *client = ds1307->client;
  821. struct mutex *lock = &ds1307->rtc->ops_lock;
  822. int control;
  823. int ret;
  824. mutex_lock(lock);
  825. control = i2c_smbus_read_byte_data(client, DS1337_REG_CONTROL);
  826. if (control < 0) {
  827. ret = control;
  828. goto out;
  829. }
  830. control &= ~mask;
  831. control |= value;
  832. ret = i2c_smbus_write_byte_data(client, DS1337_REG_CONTROL, control);
  833. out:
  834. mutex_unlock(lock);
  835. return ret;
  836. }
  837. static unsigned long ds3231_clk_sqw_recalc_rate(struct clk_hw *hw,
  838. unsigned long parent_rate)
  839. {
  840. struct ds1307 *ds1307 = clk_sqw_to_ds1307(hw);
  841. int control;
  842. int rate_sel = 0;
  843. control = i2c_smbus_read_byte_data(ds1307->client, DS1337_REG_CONTROL);
  844. if (control < 0)
  845. return control;
  846. if (control & DS1337_BIT_RS1)
  847. rate_sel += 1;
  848. if (control & DS1337_BIT_RS2)
  849. rate_sel += 2;
  850. return ds3231_clk_sqw_rates[rate_sel];
  851. }
  852. static long ds3231_clk_sqw_round_rate(struct clk_hw *hw, unsigned long rate,
  853. unsigned long *prate)
  854. {
  855. int i;
  856. for (i = ARRAY_SIZE(ds3231_clk_sqw_rates) - 1; i >= 0; i--) {
  857. if (ds3231_clk_sqw_rates[i] <= rate)
  858. return ds3231_clk_sqw_rates[i];
  859. }
  860. return 0;
  861. }
  862. static int ds3231_clk_sqw_set_rate(struct clk_hw *hw, unsigned long rate,
  863. unsigned long parent_rate)
  864. {
  865. struct ds1307 *ds1307 = clk_sqw_to_ds1307(hw);
  866. int control = 0;
  867. int rate_sel;
  868. for (rate_sel = 0; rate_sel < ARRAY_SIZE(ds3231_clk_sqw_rates);
  869. rate_sel++) {
  870. if (ds3231_clk_sqw_rates[rate_sel] == rate)
  871. break;
  872. }
  873. if (rate_sel == ARRAY_SIZE(ds3231_clk_sqw_rates))
  874. return -EINVAL;
  875. if (rate_sel & 1)
  876. control |= DS1337_BIT_RS1;
  877. if (rate_sel & 2)
  878. control |= DS1337_BIT_RS2;
  879. return ds1337_write_control(ds1307, DS1337_BIT_RS1 | DS1337_BIT_RS2,
  880. control);
  881. }
  882. static int ds3231_clk_sqw_prepare(struct clk_hw *hw)
  883. {
  884. struct ds1307 *ds1307 = clk_sqw_to_ds1307(hw);
  885. return ds1337_write_control(ds1307, DS1337_BIT_INTCN, 0);
  886. }
  887. static void ds3231_clk_sqw_unprepare(struct clk_hw *hw)
  888. {
  889. struct ds1307 *ds1307 = clk_sqw_to_ds1307(hw);
  890. ds1337_write_control(ds1307, DS1337_BIT_INTCN, DS1337_BIT_INTCN);
  891. }
  892. static int ds3231_clk_sqw_is_prepared(struct clk_hw *hw)
  893. {
  894. struct ds1307 *ds1307 = clk_sqw_to_ds1307(hw);
  895. int control;
  896. control = i2c_smbus_read_byte_data(ds1307->client, DS1337_REG_CONTROL);
  897. if (control < 0)
  898. return control;
  899. return !(control & DS1337_BIT_INTCN);
  900. }
  901. static const struct clk_ops ds3231_clk_sqw_ops = {
  902. .prepare = ds3231_clk_sqw_prepare,
  903. .unprepare = ds3231_clk_sqw_unprepare,
  904. .is_prepared = ds3231_clk_sqw_is_prepared,
  905. .recalc_rate = ds3231_clk_sqw_recalc_rate,
  906. .round_rate = ds3231_clk_sqw_round_rate,
  907. .set_rate = ds3231_clk_sqw_set_rate,
  908. };
  909. static unsigned long ds3231_clk_32khz_recalc_rate(struct clk_hw *hw,
  910. unsigned long parent_rate)
  911. {
  912. return 32768;
  913. }
  914. static int ds3231_clk_32khz_control(struct ds1307 *ds1307, bool enable)
  915. {
  916. struct i2c_client *client = ds1307->client;
  917. struct mutex *lock = &ds1307->rtc->ops_lock;
  918. int status;
  919. int ret;
  920. mutex_lock(lock);
  921. status = i2c_smbus_read_byte_data(client, DS1337_REG_STATUS);
  922. if (status < 0) {
  923. ret = status;
  924. goto out;
  925. }
  926. if (enable)
  927. status |= DS3231_BIT_EN32KHZ;
  928. else
  929. status &= ~DS3231_BIT_EN32KHZ;
  930. ret = i2c_smbus_write_byte_data(client, DS1337_REG_STATUS, status);
  931. out:
  932. mutex_unlock(lock);
  933. return ret;
  934. }
  935. static int ds3231_clk_32khz_prepare(struct clk_hw *hw)
  936. {
  937. struct ds1307 *ds1307 = clk_32khz_to_ds1307(hw);
  938. return ds3231_clk_32khz_control(ds1307, true);
  939. }
  940. static void ds3231_clk_32khz_unprepare(struct clk_hw *hw)
  941. {
  942. struct ds1307 *ds1307 = clk_32khz_to_ds1307(hw);
  943. ds3231_clk_32khz_control(ds1307, false);
  944. }
  945. static int ds3231_clk_32khz_is_prepared(struct clk_hw *hw)
  946. {
  947. struct ds1307 *ds1307 = clk_32khz_to_ds1307(hw);
  948. int status;
  949. status = i2c_smbus_read_byte_data(ds1307->client, DS1337_REG_STATUS);
  950. if (status < 0)
  951. return status;
  952. return !!(status & DS3231_BIT_EN32KHZ);
  953. }
  954. static const struct clk_ops ds3231_clk_32khz_ops = {
  955. .prepare = ds3231_clk_32khz_prepare,
  956. .unprepare = ds3231_clk_32khz_unprepare,
  957. .is_prepared = ds3231_clk_32khz_is_prepared,
  958. .recalc_rate = ds3231_clk_32khz_recalc_rate,
  959. };
  960. static struct clk_init_data ds3231_clks_init[] = {
  961. [DS3231_CLK_SQW] = {
  962. .name = "ds3231_clk_sqw",
  963. .ops = &ds3231_clk_sqw_ops,
  964. },
  965. [DS3231_CLK_32KHZ] = {
  966. .name = "ds3231_clk_32khz",
  967. .ops = &ds3231_clk_32khz_ops,
  968. },
  969. };
  970. static int ds3231_clks_register(struct ds1307 *ds1307)
  971. {
  972. struct i2c_client *client = ds1307->client;
  973. struct device_node *node = client->dev.of_node;
  974. struct clk_onecell_data *onecell;
  975. int i;
  976. onecell = devm_kzalloc(&client->dev, sizeof(*onecell), GFP_KERNEL);
  977. if (!onecell)
  978. return -ENOMEM;
  979. onecell->clk_num = ARRAY_SIZE(ds3231_clks_init);
  980. onecell->clks = devm_kcalloc(&client->dev, onecell->clk_num,
  981. sizeof(onecell->clks[0]), GFP_KERNEL);
  982. if (!onecell->clks)
  983. return -ENOMEM;
  984. for (i = 0; i < ARRAY_SIZE(ds3231_clks_init); i++) {
  985. struct clk_init_data init = ds3231_clks_init[i];
  986. /*
  987. * Interrupt signal due to alarm conditions and square-wave
  988. * output share same pin, so don't initialize both.
  989. */
  990. if (i == DS3231_CLK_SQW && test_bit(HAS_ALARM, &ds1307->flags))
  991. continue;
  992. /* optional override of the clockname */
  993. of_property_read_string_index(node, "clock-output-names", i,
  994. &init.name);
  995. ds1307->clks[i].init = &init;
  996. onecell->clks[i] = devm_clk_register(&client->dev,
  997. &ds1307->clks[i]);
  998. if (IS_ERR(onecell->clks[i]))
  999. return PTR_ERR(onecell->clks[i]);
  1000. }
  1001. if (!node)
  1002. return 0;
  1003. of_clk_add_provider(node, of_clk_src_onecell_get, onecell);
  1004. return 0;
  1005. }
  1006. static void ds1307_clks_register(struct ds1307 *ds1307)
  1007. {
  1008. int ret;
  1009. if (ds1307->type != ds_3231)
  1010. return;
  1011. ret = ds3231_clks_register(ds1307);
  1012. if (ret) {
  1013. dev_warn(&ds1307->client->dev,
  1014. "unable to register clock device %d\n", ret);
  1015. }
  1016. }
  1017. #else
  1018. static void ds1307_clks_register(struct ds1307 *ds1307)
  1019. {
  1020. }
  1021. #endif /* CONFIG_COMMON_CLK */
  1022. static int ds1307_probe(struct i2c_client *client,
  1023. const struct i2c_device_id *id)
  1024. {
  1025. struct ds1307 *ds1307;
  1026. int err = -ENODEV;
  1027. int tmp;
  1028. struct chip_desc *chip = &chips[id->driver_data];
  1029. struct i2c_adapter *adapter = to_i2c_adapter(client->dev.parent);
  1030. bool want_irq = false;
  1031. bool ds1307_can_wakeup_device = false;
  1032. unsigned char *buf;
  1033. struct ds1307_platform_data *pdata = dev_get_platdata(&client->dev);
  1034. irq_handler_t irq_handler = ds1307_irq;
  1035. static const int bbsqi_bitpos[] = {
  1036. [ds_1337] = 0,
  1037. [ds_1339] = DS1339_BIT_BBSQI,
  1038. [ds_3231] = DS3231_BIT_BBSQW,
  1039. };
  1040. const struct rtc_class_ops *rtc_ops = &ds13xx_rtc_ops;
  1041. if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_BYTE_DATA)
  1042. && !i2c_check_functionality(adapter, I2C_FUNC_SMBUS_I2C_BLOCK))
  1043. return -EIO;
  1044. ds1307 = devm_kzalloc(&client->dev, sizeof(struct ds1307), GFP_KERNEL);
  1045. if (!ds1307)
  1046. return -ENOMEM;
  1047. i2c_set_clientdata(client, ds1307);
  1048. ds1307->client = client;
  1049. ds1307->type = id->driver_data;
  1050. if (!pdata && client->dev.of_node)
  1051. ds1307_trickle_of_init(client, chip);
  1052. else if (pdata && pdata->trickle_charger_setup)
  1053. chip->trickle_charger_setup = pdata->trickle_charger_setup;
  1054. if (chip->trickle_charger_setup && chip->trickle_charger_reg) {
  1055. dev_dbg(&client->dev, "writing trickle charger info 0x%x to 0x%x\n",
  1056. DS13XX_TRICKLE_CHARGER_MAGIC | chip->trickle_charger_setup,
  1057. chip->trickle_charger_reg);
  1058. i2c_smbus_write_byte_data(client, chip->trickle_charger_reg,
  1059. DS13XX_TRICKLE_CHARGER_MAGIC |
  1060. chip->trickle_charger_setup);
  1061. }
  1062. buf = ds1307->regs;
  1063. if (i2c_check_functionality(adapter, I2C_FUNC_SMBUS_I2C_BLOCK)) {
  1064. ds1307->read_block_data = ds1307_native_smbus_read_block_data;
  1065. ds1307->write_block_data = ds1307_native_smbus_write_block_data;
  1066. } else {
  1067. ds1307->read_block_data = ds1307_read_block_data;
  1068. ds1307->write_block_data = ds1307_write_block_data;
  1069. }
  1070. #ifdef CONFIG_OF
  1071. /*
  1072. * For devices with no IRQ directly connected to the SoC, the RTC chip
  1073. * can be forced as a wakeup source by stating that explicitly in
  1074. * the device's .dts file using the "wakeup-source" boolean property.
  1075. * If the "wakeup-source" property is set, don't request an IRQ.
  1076. * This will guarantee the 'wakealarm' sysfs entry is available on the device,
  1077. * if supported by the RTC.
  1078. */
  1079. if (of_property_read_bool(client->dev.of_node, "wakeup-source")) {
  1080. ds1307_can_wakeup_device = true;
  1081. }
  1082. #endif
  1083. switch (ds1307->type) {
  1084. case ds_1337:
  1085. case ds_1339:
  1086. case ds_3231:
  1087. /* get registers that the "rtc" read below won't read... */
  1088. tmp = ds1307->read_block_data(ds1307->client,
  1089. DS1337_REG_CONTROL, 2, buf);
  1090. if (tmp != 2) {
  1091. dev_dbg(&client->dev, "read error %d\n", tmp);
  1092. err = -EIO;
  1093. goto exit;
  1094. }
  1095. /* oscillator off? turn it on, so clock can tick. */
  1096. if (ds1307->regs[0] & DS1337_BIT_nEOSC)
  1097. ds1307->regs[0] &= ~DS1337_BIT_nEOSC;
  1098. /*
  1099. * Using IRQ or defined as wakeup-source?
  1100. * Disable the square wave and both alarms.
  1101. * For some variants, be sure alarms can trigger when we're
  1102. * running on Vbackup (BBSQI/BBSQW)
  1103. */
  1104. if (chip->alarm && (ds1307->client->irq > 0 ||
  1105. ds1307_can_wakeup_device)) {
  1106. ds1307->regs[0] |= DS1337_BIT_INTCN
  1107. | bbsqi_bitpos[ds1307->type];
  1108. ds1307->regs[0] &= ~(DS1337_BIT_A2IE | DS1337_BIT_A1IE);
  1109. want_irq = true;
  1110. }
  1111. i2c_smbus_write_byte_data(client, DS1337_REG_CONTROL,
  1112. ds1307->regs[0]);
  1113. /* oscillator fault? clear flag, and warn */
  1114. if (ds1307->regs[1] & DS1337_BIT_OSF) {
  1115. i2c_smbus_write_byte_data(client, DS1337_REG_STATUS,
  1116. ds1307->regs[1] & ~DS1337_BIT_OSF);
  1117. dev_warn(&client->dev, "SET TIME!\n");
  1118. }
  1119. break;
  1120. case rx_8025:
  1121. tmp = i2c_smbus_read_i2c_block_data(ds1307->client,
  1122. RX8025_REG_CTRL1 << 4 | 0x08, 2, buf);
  1123. if (tmp != 2) {
  1124. dev_dbg(&client->dev, "read error %d\n", tmp);
  1125. err = -EIO;
  1126. goto exit;
  1127. }
  1128. /* oscillator off? turn it on, so clock can tick. */
  1129. if (!(ds1307->regs[1] & RX8025_BIT_XST)) {
  1130. ds1307->regs[1] |= RX8025_BIT_XST;
  1131. i2c_smbus_write_byte_data(client,
  1132. RX8025_REG_CTRL2 << 4 | 0x08,
  1133. ds1307->regs[1]);
  1134. dev_warn(&client->dev,
  1135. "oscillator stop detected - SET TIME!\n");
  1136. }
  1137. if (ds1307->regs[1] & RX8025_BIT_PON) {
  1138. ds1307->regs[1] &= ~RX8025_BIT_PON;
  1139. i2c_smbus_write_byte_data(client,
  1140. RX8025_REG_CTRL2 << 4 | 0x08,
  1141. ds1307->regs[1]);
  1142. dev_warn(&client->dev, "power-on detected\n");
  1143. }
  1144. if (ds1307->regs[1] & RX8025_BIT_VDET) {
  1145. ds1307->regs[1] &= ~RX8025_BIT_VDET;
  1146. i2c_smbus_write_byte_data(client,
  1147. RX8025_REG_CTRL2 << 4 | 0x08,
  1148. ds1307->regs[1]);
  1149. dev_warn(&client->dev, "voltage drop detected\n");
  1150. }
  1151. /* make sure we are running in 24hour mode */
  1152. if (!(ds1307->regs[0] & RX8025_BIT_2412)) {
  1153. u8 hour;
  1154. /* switch to 24 hour mode */
  1155. i2c_smbus_write_byte_data(client,
  1156. RX8025_REG_CTRL1 << 4 | 0x08,
  1157. ds1307->regs[0] |
  1158. RX8025_BIT_2412);
  1159. tmp = i2c_smbus_read_i2c_block_data(ds1307->client,
  1160. RX8025_REG_CTRL1 << 4 | 0x08, 2, buf);
  1161. if (tmp != 2) {
  1162. dev_dbg(&client->dev, "read error %d\n", tmp);
  1163. err = -EIO;
  1164. goto exit;
  1165. }
  1166. /* correct hour */
  1167. hour = bcd2bin(ds1307->regs[DS1307_REG_HOUR]);
  1168. if (hour == 12)
  1169. hour = 0;
  1170. if (ds1307->regs[DS1307_REG_HOUR] & DS1307_BIT_PM)
  1171. hour += 12;
  1172. i2c_smbus_write_byte_data(client,
  1173. DS1307_REG_HOUR << 4 | 0x08,
  1174. hour);
  1175. }
  1176. break;
  1177. case ds_1388:
  1178. ds1307->offset = 1; /* Seconds starts at 1 */
  1179. break;
  1180. case mcp794xx:
  1181. rtc_ops = &mcp794xx_rtc_ops;
  1182. if (ds1307->client->irq > 0 && chip->alarm) {
  1183. irq_handler = mcp794xx_irq;
  1184. want_irq = true;
  1185. }
  1186. break;
  1187. default:
  1188. break;
  1189. }
  1190. read_rtc:
  1191. /* read RTC registers */
  1192. tmp = ds1307->read_block_data(ds1307->client, ds1307->offset, 8, buf);
  1193. if (tmp != 8) {
  1194. dev_dbg(&client->dev, "read error %d\n", tmp);
  1195. err = -EIO;
  1196. goto exit;
  1197. }
  1198. /*
  1199. * minimal sanity checking; some chips (like DS1340) don't
  1200. * specify the extra bits as must-be-zero, but there are
  1201. * still a few values that are clearly out-of-range.
  1202. */
  1203. tmp = ds1307->regs[DS1307_REG_SECS];
  1204. switch (ds1307->type) {
  1205. case ds_1307:
  1206. case m41t00:
  1207. /* clock halted? turn it on, so clock can tick. */
  1208. if (tmp & DS1307_BIT_CH) {
  1209. i2c_smbus_write_byte_data(client, DS1307_REG_SECS, 0);
  1210. dev_warn(&client->dev, "SET TIME!\n");
  1211. goto read_rtc;
  1212. }
  1213. break;
  1214. case ds_1338:
  1215. /* clock halted? turn it on, so clock can tick. */
  1216. if (tmp & DS1307_BIT_CH)
  1217. i2c_smbus_write_byte_data(client, DS1307_REG_SECS, 0);
  1218. /* oscillator fault? clear flag, and warn */
  1219. if (ds1307->regs[DS1307_REG_CONTROL] & DS1338_BIT_OSF) {
  1220. i2c_smbus_write_byte_data(client, DS1307_REG_CONTROL,
  1221. ds1307->regs[DS1307_REG_CONTROL]
  1222. & ~DS1338_BIT_OSF);
  1223. dev_warn(&client->dev, "SET TIME!\n");
  1224. goto read_rtc;
  1225. }
  1226. break;
  1227. case ds_1340:
  1228. /* clock halted? turn it on, so clock can tick. */
  1229. if (tmp & DS1340_BIT_nEOSC)
  1230. i2c_smbus_write_byte_data(client, DS1307_REG_SECS, 0);
  1231. tmp = i2c_smbus_read_byte_data(client, DS1340_REG_FLAG);
  1232. if (tmp < 0) {
  1233. dev_dbg(&client->dev, "read error %d\n", tmp);
  1234. err = -EIO;
  1235. goto exit;
  1236. }
  1237. /* oscillator fault? clear flag, and warn */
  1238. if (tmp & DS1340_BIT_OSF) {
  1239. i2c_smbus_write_byte_data(client, DS1340_REG_FLAG, 0);
  1240. dev_warn(&client->dev, "SET TIME!\n");
  1241. }
  1242. break;
  1243. case mcp794xx:
  1244. /* make sure that the backup battery is enabled */
  1245. if (!(ds1307->regs[DS1307_REG_WDAY] & MCP794XX_BIT_VBATEN)) {
  1246. i2c_smbus_write_byte_data(client, DS1307_REG_WDAY,
  1247. ds1307->regs[DS1307_REG_WDAY]
  1248. | MCP794XX_BIT_VBATEN);
  1249. }
  1250. /* clock halted? turn it on, so clock can tick. */
  1251. if (!(tmp & MCP794XX_BIT_ST)) {
  1252. i2c_smbus_write_byte_data(client, DS1307_REG_SECS,
  1253. MCP794XX_BIT_ST);
  1254. dev_warn(&client->dev, "SET TIME!\n");
  1255. goto read_rtc;
  1256. }
  1257. break;
  1258. default:
  1259. break;
  1260. }
  1261. tmp = ds1307->regs[DS1307_REG_HOUR];
  1262. switch (ds1307->type) {
  1263. case ds_1340:
  1264. case m41t00:
  1265. /*
  1266. * NOTE: ignores century bits; fix before deploying
  1267. * systems that will run through year 2100.
  1268. */
  1269. break;
  1270. case rx_8025:
  1271. break;
  1272. default:
  1273. if (!(tmp & DS1307_BIT_12HR))
  1274. break;
  1275. /*
  1276. * Be sure we're in 24 hour mode. Multi-master systems
  1277. * take note...
  1278. */
  1279. tmp = bcd2bin(tmp & 0x1f);
  1280. if (tmp == 12)
  1281. tmp = 0;
  1282. if (ds1307->regs[DS1307_REG_HOUR] & DS1307_BIT_PM)
  1283. tmp += 12;
  1284. i2c_smbus_write_byte_data(client,
  1285. ds1307->offset + DS1307_REG_HOUR,
  1286. bin2bcd(tmp));
  1287. }
  1288. if (want_irq) {
  1289. device_set_wakeup_capable(&client->dev, true);
  1290. set_bit(HAS_ALARM, &ds1307->flags);
  1291. }
  1292. ds1307->rtc = devm_rtc_device_register(&client->dev, client->name,
  1293. rtc_ops, THIS_MODULE);
  1294. if (IS_ERR(ds1307->rtc)) {
  1295. return PTR_ERR(ds1307->rtc);
  1296. }
  1297. if (ds1307_can_wakeup_device && ds1307->client->irq <= 0) {
  1298. /* Disable request for an IRQ */
  1299. want_irq = false;
  1300. dev_info(&client->dev, "'wakeup-source' is set, request for an IRQ is disabled!\n");
  1301. /* We cannot support UIE mode if we do not have an IRQ line */
  1302. ds1307->rtc->uie_unsupported = 1;
  1303. }
  1304. if (want_irq) {
  1305. err = devm_request_threaded_irq(&client->dev,
  1306. client->irq, NULL, irq_handler,
  1307. IRQF_SHARED | IRQF_ONESHOT,
  1308. ds1307->rtc->name, client);
  1309. if (err) {
  1310. client->irq = 0;
  1311. device_set_wakeup_capable(&client->dev, false);
  1312. clear_bit(HAS_ALARM, &ds1307->flags);
  1313. dev_err(&client->dev, "unable to request IRQ!\n");
  1314. } else
  1315. dev_dbg(&client->dev, "got IRQ %d\n", client->irq);
  1316. }
  1317. if (chip->nvram_size) {
  1318. ds1307->nvram = devm_kzalloc(&client->dev,
  1319. sizeof(struct bin_attribute),
  1320. GFP_KERNEL);
  1321. if (!ds1307->nvram) {
  1322. dev_err(&client->dev, "cannot allocate memory for nvram sysfs\n");
  1323. } else {
  1324. ds1307->nvram->attr.name = "nvram";
  1325. ds1307->nvram->attr.mode = S_IRUGO | S_IWUSR;
  1326. sysfs_bin_attr_init(ds1307->nvram);
  1327. ds1307->nvram->read = ds1307_nvram_read;
  1328. ds1307->nvram->write = ds1307_nvram_write;
  1329. ds1307->nvram->size = chip->nvram_size;
  1330. ds1307->nvram_offset = chip->nvram_offset;
  1331. err = sysfs_create_bin_file(&client->dev.kobj,
  1332. ds1307->nvram);
  1333. if (err) {
  1334. dev_err(&client->dev,
  1335. "unable to create sysfs file: %s\n",
  1336. ds1307->nvram->attr.name);
  1337. } else {
  1338. set_bit(HAS_NVRAM, &ds1307->flags);
  1339. dev_info(&client->dev, "%zu bytes nvram\n",
  1340. ds1307->nvram->size);
  1341. }
  1342. }
  1343. }
  1344. ds1307_hwmon_register(ds1307);
  1345. ds1307_clks_register(ds1307);
  1346. return 0;
  1347. exit:
  1348. return err;
  1349. }
  1350. static int ds1307_remove(struct i2c_client *client)
  1351. {
  1352. struct ds1307 *ds1307 = i2c_get_clientdata(client);
  1353. if (test_and_clear_bit(HAS_NVRAM, &ds1307->flags))
  1354. sysfs_remove_bin_file(&client->dev.kobj, ds1307->nvram);
  1355. return 0;
  1356. }
  1357. static struct i2c_driver ds1307_driver = {
  1358. .driver = {
  1359. .name = "rtc-ds1307",
  1360. },
  1361. .probe = ds1307_probe,
  1362. .remove = ds1307_remove,
  1363. .id_table = ds1307_id,
  1364. };
  1365. module_i2c_driver(ds1307_driver);
  1366. MODULE_DESCRIPTION("RTC driver for DS1307 and similar chips");
  1367. MODULE_LICENSE("GPL");