pmbus_core.c 40 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571
  1. /*
  2. * Hardware monitoring driver for PMBus devices
  3. *
  4. * Copyright (c) 2010, 2011 Ericsson AB.
  5. *
  6. * This program is free software; you can redistribute it and/or modify
  7. * it under the terms of the GNU General Public License as published by
  8. * the Free Software Foundation; either version 2 of the License, or
  9. * (at your option) any later version.
  10. *
  11. * This program is distributed in the hope that it will be useful,
  12. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  14. * GNU General Public License for more details.
  15. *
  16. * You should have received a copy of the GNU General Public License
  17. * along with this program; if not, write to the Free Software
  18. * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  19. */
  20. #include <linux/kernel.h>
  21. #include <linux/module.h>
  22. #include <linux/init.h>
  23. #include <linux/err.h>
  24. #include <linux/slab.h>
  25. #include <linux/i2c.h>
  26. #include <linux/hwmon.h>
  27. #include <linux/hwmon-sysfs.h>
  28. #include <linux/delay.h>
  29. #include <linux/i2c/pmbus.h>
  30. #include "pmbus.h"
  31. /*
  32. * Constants needed to determine number of sensors, booleans, and labels.
  33. */
  34. #define PMBUS_MAX_INPUT_SENSORS 11 /* 6*volt, 3*curr, 2*power */
  35. #define PMBUS_VOUT_SENSORS_PER_PAGE 5 /* input, min, max, lcrit,
  36. crit */
  37. #define PMBUS_IOUT_SENSORS_PER_PAGE 4 /* input, min, max, crit */
  38. #define PMBUS_POUT_SENSORS_PER_PAGE 4 /* input, cap, max, crit */
  39. #define PMBUS_MAX_SENSORS_PER_FAN 1 /* input */
  40. #define PMBUS_MAX_SENSORS_PER_TEMP 5 /* input, min, max, lcrit,
  41. crit */
  42. #define PMBUS_MAX_INPUT_BOOLEANS 7 /* v: min_alarm, max_alarm,
  43. lcrit_alarm, crit_alarm;
  44. c: alarm, crit_alarm;
  45. p: crit_alarm */
  46. #define PMBUS_VOUT_BOOLEANS_PER_PAGE 4 /* min_alarm, max_alarm,
  47. lcrit_alarm, crit_alarm */
  48. #define PMBUS_IOUT_BOOLEANS_PER_PAGE 3 /* alarm, lcrit_alarm,
  49. crit_alarm */
  50. #define PMBUS_POUT_BOOLEANS_PER_PAGE 2 /* alarm, crit_alarm */
  51. #define PMBUS_MAX_BOOLEANS_PER_FAN 2 /* alarm, fault */
  52. #define PMBUS_MAX_BOOLEANS_PER_TEMP 4 /* min_alarm, max_alarm,
  53. lcrit_alarm, crit_alarm */
  54. #define PMBUS_MAX_INPUT_LABELS 4 /* vin, vcap, iin, pin */
  55. /*
  56. * status, status_vout, status_iout, status_fans, status_fan34, and status_temp
  57. * are paged. status_input is unpaged.
  58. */
  59. #define PB_NUM_STATUS_REG (PMBUS_PAGES * 6 + 1)
  60. /*
  61. * Index into status register array, per status register group
  62. */
  63. #define PB_STATUS_BASE 0
  64. #define PB_STATUS_VOUT_BASE (PB_STATUS_BASE + PMBUS_PAGES)
  65. #define PB_STATUS_IOUT_BASE (PB_STATUS_VOUT_BASE + PMBUS_PAGES)
  66. #define PB_STATUS_FAN_BASE (PB_STATUS_IOUT_BASE + PMBUS_PAGES)
  67. #define PB_STATUS_FAN34_BASE (PB_STATUS_FAN_BASE + PMBUS_PAGES)
  68. #define PB_STATUS_INPUT_BASE (PB_STATUS_FAN34_BASE + PMBUS_PAGES)
  69. #define PB_STATUS_TEMP_BASE (PB_STATUS_INPUT_BASE + 1)
  70. struct pmbus_sensor {
  71. char name[I2C_NAME_SIZE]; /* sysfs sensor name */
  72. struct sensor_device_attribute attribute;
  73. u8 page; /* page number */
  74. u8 reg; /* register */
  75. enum pmbus_sensor_classes class; /* sensor class */
  76. bool update; /* runtime sensor update needed */
  77. int data; /* Sensor data.
  78. Negative if there was a read error */
  79. };
  80. struct pmbus_boolean {
  81. char name[I2C_NAME_SIZE]; /* sysfs boolean name */
  82. struct sensor_device_attribute attribute;
  83. };
  84. struct pmbus_label {
  85. char name[I2C_NAME_SIZE]; /* sysfs label name */
  86. struct sensor_device_attribute attribute;
  87. char label[I2C_NAME_SIZE]; /* label */
  88. };
  89. struct pmbus_data {
  90. struct device *hwmon_dev;
  91. u32 flags; /* from platform data */
  92. int exponent; /* linear mode: exponent for output voltages */
  93. const struct pmbus_driver_info *info;
  94. int max_attributes;
  95. int num_attributes;
  96. struct attribute **attributes;
  97. struct attribute_group group;
  98. /*
  99. * Sensors cover both sensor and limit registers.
  100. */
  101. int max_sensors;
  102. int num_sensors;
  103. struct pmbus_sensor *sensors;
  104. /*
  105. * Booleans are used for alarms.
  106. * Values are determined from status registers.
  107. */
  108. int max_booleans;
  109. int num_booleans;
  110. struct pmbus_boolean *booleans;
  111. /*
  112. * Labels are used to map generic names (e.g., "in1")
  113. * to PMBus specific names (e.g., "vin" or "vout1").
  114. */
  115. int max_labels;
  116. int num_labels;
  117. struct pmbus_label *labels;
  118. struct mutex update_lock;
  119. bool valid;
  120. unsigned long last_updated; /* in jiffies */
  121. /*
  122. * A single status register covers multiple attributes,
  123. * so we keep them all together.
  124. */
  125. u8 status[PB_NUM_STATUS_REG];
  126. u8 currpage;
  127. };
  128. int pmbus_set_page(struct i2c_client *client, u8 page)
  129. {
  130. struct pmbus_data *data = i2c_get_clientdata(client);
  131. int rv = 0;
  132. int newpage;
  133. if (page != data->currpage) {
  134. rv = i2c_smbus_write_byte_data(client, PMBUS_PAGE, page);
  135. newpage = i2c_smbus_read_byte_data(client, PMBUS_PAGE);
  136. if (newpage != page)
  137. rv = -EINVAL;
  138. else
  139. data->currpage = page;
  140. }
  141. return rv;
  142. }
  143. EXPORT_SYMBOL_GPL(pmbus_set_page);
  144. static int pmbus_write_byte(struct i2c_client *client, u8 page, u8 value)
  145. {
  146. int rv;
  147. rv = pmbus_set_page(client, page);
  148. if (rv < 0)
  149. return rv;
  150. return i2c_smbus_write_byte(client, value);
  151. }
  152. static int pmbus_write_word_data(struct i2c_client *client, u8 page, u8 reg,
  153. u16 word)
  154. {
  155. int rv;
  156. rv = pmbus_set_page(client, page);
  157. if (rv < 0)
  158. return rv;
  159. return i2c_smbus_write_word_data(client, reg, word);
  160. }
  161. int pmbus_read_word_data(struct i2c_client *client, u8 page, u8 reg)
  162. {
  163. int rv;
  164. rv = pmbus_set_page(client, page);
  165. if (rv < 0)
  166. return rv;
  167. return i2c_smbus_read_word_data(client, reg);
  168. }
  169. EXPORT_SYMBOL_GPL(pmbus_read_word_data);
  170. static int pmbus_read_byte_data(struct i2c_client *client, u8 page, u8 reg)
  171. {
  172. int rv;
  173. rv = pmbus_set_page(client, page);
  174. if (rv < 0)
  175. return rv;
  176. return i2c_smbus_read_byte_data(client, reg);
  177. }
  178. static void pmbus_clear_fault_page(struct i2c_client *client, int page)
  179. {
  180. pmbus_write_byte(client, page, PMBUS_CLEAR_FAULTS);
  181. }
  182. void pmbus_clear_faults(struct i2c_client *client)
  183. {
  184. struct pmbus_data *data = i2c_get_clientdata(client);
  185. int i;
  186. for (i = 0; i < data->info->pages; i++)
  187. pmbus_clear_fault_page(client, i);
  188. }
  189. EXPORT_SYMBOL_GPL(pmbus_clear_faults);
  190. static int pmbus_check_status_cml(struct i2c_client *client, int page)
  191. {
  192. int status, status2;
  193. status = pmbus_read_byte_data(client, page, PMBUS_STATUS_BYTE);
  194. if (status < 0 || (status & PB_STATUS_CML)) {
  195. status2 = pmbus_read_byte_data(client, page, PMBUS_STATUS_CML);
  196. if (status2 < 0 || (status2 & PB_CML_FAULT_INVALID_COMMAND))
  197. return -EINVAL;
  198. }
  199. return 0;
  200. }
  201. bool pmbus_check_byte_register(struct i2c_client *client, int page, int reg)
  202. {
  203. int rv;
  204. struct pmbus_data *data = i2c_get_clientdata(client);
  205. rv = pmbus_read_byte_data(client, page, reg);
  206. if (rv >= 0 && !(data->flags & PMBUS_SKIP_STATUS_CHECK))
  207. rv = pmbus_check_status_cml(client, page);
  208. pmbus_clear_fault_page(client, page);
  209. return rv >= 0;
  210. }
  211. EXPORT_SYMBOL_GPL(pmbus_check_byte_register);
  212. bool pmbus_check_word_register(struct i2c_client *client, int page, int reg)
  213. {
  214. int rv;
  215. struct pmbus_data *data = i2c_get_clientdata(client);
  216. rv = pmbus_read_word_data(client, page, reg);
  217. if (rv >= 0 && !(data->flags & PMBUS_SKIP_STATUS_CHECK))
  218. rv = pmbus_check_status_cml(client, page);
  219. pmbus_clear_fault_page(client, page);
  220. return rv >= 0;
  221. }
  222. EXPORT_SYMBOL_GPL(pmbus_check_word_register);
  223. const struct pmbus_driver_info *pmbus_get_driver_info(struct i2c_client *client)
  224. {
  225. struct pmbus_data *data = i2c_get_clientdata(client);
  226. return data->info;
  227. }
  228. EXPORT_SYMBOL_GPL(pmbus_get_driver_info);
  229. /*
  230. * _pmbus_read_byte_data() is similar to pmbus_read_byte_data(), but checks if
  231. * a device specific mapping funcion exists and calls it if necessary.
  232. */
  233. static int _pmbus_read_byte_data(struct i2c_client *client, int page, int reg)
  234. {
  235. struct pmbus_data *data = i2c_get_clientdata(client);
  236. const struct pmbus_driver_info *info = data->info;
  237. int status;
  238. if (info->read_byte_data) {
  239. status = info->read_byte_data(client, page, reg);
  240. if (status != -ENODATA)
  241. return status;
  242. }
  243. return pmbus_read_byte_data(client, page, reg);
  244. }
  245. static struct pmbus_data *pmbus_update_device(struct device *dev)
  246. {
  247. struct i2c_client *client = to_i2c_client(dev);
  248. struct pmbus_data *data = i2c_get_clientdata(client);
  249. const struct pmbus_driver_info *info = data->info;
  250. mutex_lock(&data->update_lock);
  251. if (time_after(jiffies, data->last_updated + HZ) || !data->valid) {
  252. int i;
  253. for (i = 0; i < info->pages; i++)
  254. data->status[PB_STATUS_BASE + i]
  255. = pmbus_read_byte_data(client, i,
  256. PMBUS_STATUS_BYTE);
  257. for (i = 0; i < info->pages; i++) {
  258. if (!(info->func[i] & PMBUS_HAVE_STATUS_VOUT))
  259. continue;
  260. data->status[PB_STATUS_VOUT_BASE + i]
  261. = _pmbus_read_byte_data(client, i, PMBUS_STATUS_VOUT);
  262. }
  263. for (i = 0; i < info->pages; i++) {
  264. if (!(info->func[i] & PMBUS_HAVE_STATUS_IOUT))
  265. continue;
  266. data->status[PB_STATUS_IOUT_BASE + i]
  267. = _pmbus_read_byte_data(client, i, PMBUS_STATUS_IOUT);
  268. }
  269. for (i = 0; i < info->pages; i++) {
  270. if (!(info->func[i] & PMBUS_HAVE_STATUS_TEMP))
  271. continue;
  272. data->status[PB_STATUS_TEMP_BASE + i]
  273. = _pmbus_read_byte_data(client, i,
  274. PMBUS_STATUS_TEMPERATURE);
  275. }
  276. for (i = 0; i < info->pages; i++) {
  277. if (!(info->func[i] & PMBUS_HAVE_STATUS_FAN12))
  278. continue;
  279. data->status[PB_STATUS_FAN_BASE + i]
  280. = _pmbus_read_byte_data(client, i,
  281. PMBUS_STATUS_FAN_12);
  282. }
  283. for (i = 0; i < info->pages; i++) {
  284. if (!(info->func[i] & PMBUS_HAVE_STATUS_FAN34))
  285. continue;
  286. data->status[PB_STATUS_FAN34_BASE + i]
  287. = _pmbus_read_byte_data(client, i,
  288. PMBUS_STATUS_FAN_34);
  289. }
  290. if (info->func[0] & PMBUS_HAVE_STATUS_INPUT)
  291. data->status[PB_STATUS_INPUT_BASE]
  292. = _pmbus_read_byte_data(client, 0,
  293. PMBUS_STATUS_INPUT);
  294. for (i = 0; i < data->num_sensors; i++) {
  295. struct pmbus_sensor *sensor = &data->sensors[i];
  296. if (!data->valid || sensor->update)
  297. sensor->data
  298. = pmbus_read_word_data(client, sensor->page,
  299. sensor->reg);
  300. }
  301. pmbus_clear_faults(client);
  302. data->last_updated = jiffies;
  303. data->valid = 1;
  304. }
  305. mutex_unlock(&data->update_lock);
  306. return data;
  307. }
  308. /*
  309. * Convert linear sensor values to milli- or micro-units
  310. * depending on sensor type.
  311. */
  312. static int pmbus_reg2data_linear(struct pmbus_data *data,
  313. struct pmbus_sensor *sensor)
  314. {
  315. s16 exponent;
  316. s32 mantissa;
  317. long val;
  318. if (sensor->class == PSC_VOLTAGE_OUT) { /* LINEAR16 */
  319. exponent = data->exponent;
  320. mantissa = (u16) sensor->data;
  321. } else { /* LINEAR11 */
  322. exponent = (sensor->data >> 11) & 0x001f;
  323. mantissa = sensor->data & 0x07ff;
  324. if (exponent > 0x0f)
  325. exponent |= 0xffe0; /* sign extend exponent */
  326. if (mantissa > 0x03ff)
  327. mantissa |= 0xfffff800; /* sign extend mantissa */
  328. }
  329. val = mantissa;
  330. /* scale result to milli-units for all sensors except fans */
  331. if (sensor->class != PSC_FAN)
  332. val = val * 1000L;
  333. /* scale result to micro-units for power sensors */
  334. if (sensor->class == PSC_POWER)
  335. val = val * 1000L;
  336. if (exponent >= 0)
  337. val <<= exponent;
  338. else
  339. val >>= -exponent;
  340. return (int)val;
  341. }
  342. /*
  343. * Convert direct sensor values to milli- or micro-units
  344. * depending on sensor type.
  345. */
  346. static int pmbus_reg2data_direct(struct pmbus_data *data,
  347. struct pmbus_sensor *sensor)
  348. {
  349. long val = (s16) sensor->data;
  350. long m, b, R;
  351. m = data->info->m[sensor->class];
  352. b = data->info->b[sensor->class];
  353. R = data->info->R[sensor->class];
  354. if (m == 0)
  355. return 0;
  356. /* X = 1/m * (Y * 10^-R - b) */
  357. R = -R;
  358. /* scale result to milli-units for everything but fans */
  359. if (sensor->class != PSC_FAN) {
  360. R += 3;
  361. b *= 1000;
  362. }
  363. /* scale result to micro-units for power sensors */
  364. if (sensor->class == PSC_POWER) {
  365. R += 3;
  366. b *= 1000;
  367. }
  368. while (R > 0) {
  369. val *= 10;
  370. R--;
  371. }
  372. while (R < 0) {
  373. val = DIV_ROUND_CLOSEST(val, 10);
  374. R++;
  375. }
  376. return (int)((val - b) / m);
  377. }
  378. static int pmbus_reg2data(struct pmbus_data *data, struct pmbus_sensor *sensor)
  379. {
  380. int val;
  381. if (data->info->direct[sensor->class])
  382. val = pmbus_reg2data_direct(data, sensor);
  383. else
  384. val = pmbus_reg2data_linear(data, sensor);
  385. return val;
  386. }
  387. #define MAX_MANTISSA (1023 * 1000)
  388. #define MIN_MANTISSA (511 * 1000)
  389. static u16 pmbus_data2reg_linear(struct pmbus_data *data,
  390. enum pmbus_sensor_classes class, long val)
  391. {
  392. s16 exponent = 0, mantissa;
  393. bool negative = false;
  394. /* simple case */
  395. if (val == 0)
  396. return 0;
  397. if (class == PSC_VOLTAGE_OUT) {
  398. /* LINEAR16 does not support negative voltages */
  399. if (val < 0)
  400. return 0;
  401. /*
  402. * For a static exponents, we don't have a choice
  403. * but to adjust the value to it.
  404. */
  405. if (data->exponent < 0)
  406. val <<= -data->exponent;
  407. else
  408. val >>= data->exponent;
  409. val = DIV_ROUND_CLOSEST(val, 1000);
  410. return val & 0xffff;
  411. }
  412. if (val < 0) {
  413. negative = true;
  414. val = -val;
  415. }
  416. /* Power is in uW. Convert to mW before converting. */
  417. if (class == PSC_POWER)
  418. val = DIV_ROUND_CLOSEST(val, 1000L);
  419. /*
  420. * For simplicity, convert fan data to milli-units
  421. * before calculating the exponent.
  422. */
  423. if (class == PSC_FAN)
  424. val = val * 1000;
  425. /* Reduce large mantissa until it fits into 10 bit */
  426. while (val >= MAX_MANTISSA && exponent < 15) {
  427. exponent++;
  428. val >>= 1;
  429. }
  430. /* Increase small mantissa to improve precision */
  431. while (val < MIN_MANTISSA && exponent > -15) {
  432. exponent--;
  433. val <<= 1;
  434. }
  435. /* Convert mantissa from milli-units to units */
  436. mantissa = DIV_ROUND_CLOSEST(val, 1000);
  437. /* Ensure that resulting number is within range */
  438. if (mantissa > 0x3ff)
  439. mantissa = 0x3ff;
  440. /* restore sign */
  441. if (negative)
  442. mantissa = -mantissa;
  443. /* Convert to 5 bit exponent, 11 bit mantissa */
  444. return (mantissa & 0x7ff) | ((exponent << 11) & 0xf800);
  445. }
  446. static u16 pmbus_data2reg_direct(struct pmbus_data *data,
  447. enum pmbus_sensor_classes class, long val)
  448. {
  449. long m, b, R;
  450. m = data->info->m[class];
  451. b = data->info->b[class];
  452. R = data->info->R[class];
  453. /* Power is in uW. Adjust R and b. */
  454. if (class == PSC_POWER) {
  455. R -= 3;
  456. b *= 1000;
  457. }
  458. /* Calculate Y = (m * X + b) * 10^R */
  459. if (class != PSC_FAN) {
  460. R -= 3; /* Adjust R and b for data in milli-units */
  461. b *= 1000;
  462. }
  463. val = val * m + b;
  464. while (R > 0) {
  465. val *= 10;
  466. R--;
  467. }
  468. while (R < 0) {
  469. val = DIV_ROUND_CLOSEST(val, 10);
  470. R++;
  471. }
  472. return val;
  473. }
  474. static u16 pmbus_data2reg(struct pmbus_data *data,
  475. enum pmbus_sensor_classes class, long val)
  476. {
  477. u16 regval;
  478. if (data->info->direct[class])
  479. regval = pmbus_data2reg_direct(data, class, val);
  480. else
  481. regval = pmbus_data2reg_linear(data, class, val);
  482. return regval;
  483. }
  484. /*
  485. * Return boolean calculated from converted data.
  486. * <index> defines a status register index and mask, and optionally
  487. * two sensor indexes.
  488. * The upper half-word references the two sensors,
  489. * two sensor indices.
  490. * The upper half-word references the two optional sensors,
  491. * the lower half word references status register and mask.
  492. * The function returns true if (status[reg] & mask) is true and,
  493. * if specified, if v1 >= v2.
  494. * To determine if an object exceeds upper limits, specify <v, limit>.
  495. * To determine if an object exceeds lower limits, specify <limit, v>.
  496. *
  497. * For booleans created with pmbus_add_boolean_reg(), only the lower 16 bits of
  498. * index are set. s1 and s2 (the sensor index values) are zero in this case.
  499. * The function returns true if (status[reg] & mask) is true.
  500. *
  501. * If the boolean was created with pmbus_add_boolean_cmp(), a comparison against
  502. * a specified limit has to be performed to determine the boolean result.
  503. * In this case, the function returns true if v1 >= v2 (where v1 and v2 are
  504. * sensor values referenced by sensor indices s1 and s2).
  505. *
  506. * To determine if an object exceeds upper limits, specify <s1,s2> = <v,limit>.
  507. * To determine if an object exceeds lower limits, specify <s1,s2> = <limit,v>.
  508. *
  509. * If a negative value is stored in any of the referenced registers, this value
  510. * reflects an error code which will be returned.
  511. */
  512. static int pmbus_get_boolean(struct pmbus_data *data, int index, int *val)
  513. {
  514. u8 s1 = (index >> 24) & 0xff;
  515. u8 s2 = (index >> 16) & 0xff;
  516. u8 reg = (index >> 8) & 0xff;
  517. u8 mask = index & 0xff;
  518. int status;
  519. u8 regval;
  520. status = data->status[reg];
  521. if (status < 0)
  522. return status;
  523. regval = status & mask;
  524. if (!s1 && !s2)
  525. *val = !!regval;
  526. else {
  527. int v1, v2;
  528. struct pmbus_sensor *sensor1, *sensor2;
  529. sensor1 = &data->sensors[s1];
  530. if (sensor1->data < 0)
  531. return sensor1->data;
  532. sensor2 = &data->sensors[s2];
  533. if (sensor2->data < 0)
  534. return sensor2->data;
  535. v1 = pmbus_reg2data(data, sensor1);
  536. v2 = pmbus_reg2data(data, sensor2);
  537. *val = !!(regval && v1 >= v2);
  538. }
  539. return 0;
  540. }
  541. static ssize_t pmbus_show_boolean(struct device *dev,
  542. struct device_attribute *da, char *buf)
  543. {
  544. struct sensor_device_attribute *attr = to_sensor_dev_attr(da);
  545. struct pmbus_data *data = pmbus_update_device(dev);
  546. int val;
  547. int err;
  548. err = pmbus_get_boolean(data, attr->index, &val);
  549. if (err)
  550. return err;
  551. return snprintf(buf, PAGE_SIZE, "%d\n", val);
  552. }
  553. static ssize_t pmbus_show_sensor(struct device *dev,
  554. struct device_attribute *da, char *buf)
  555. {
  556. struct sensor_device_attribute *attr = to_sensor_dev_attr(da);
  557. struct pmbus_data *data = pmbus_update_device(dev);
  558. struct pmbus_sensor *sensor;
  559. sensor = &data->sensors[attr->index];
  560. if (sensor->data < 0)
  561. return sensor->data;
  562. return snprintf(buf, PAGE_SIZE, "%d\n", pmbus_reg2data(data, sensor));
  563. }
  564. static ssize_t pmbus_set_sensor(struct device *dev,
  565. struct device_attribute *devattr,
  566. const char *buf, size_t count)
  567. {
  568. struct sensor_device_attribute *attr = to_sensor_dev_attr(devattr);
  569. struct i2c_client *client = to_i2c_client(dev);
  570. struct pmbus_data *data = i2c_get_clientdata(client);
  571. struct pmbus_sensor *sensor = &data->sensors[attr->index];
  572. ssize_t rv = count;
  573. long val = 0;
  574. int ret;
  575. u16 regval;
  576. if (strict_strtol(buf, 10, &val) < 0)
  577. return -EINVAL;
  578. mutex_lock(&data->update_lock);
  579. regval = pmbus_data2reg(data, sensor->class, val);
  580. ret = pmbus_write_word_data(client, sensor->page, sensor->reg, regval);
  581. if (ret < 0)
  582. rv = ret;
  583. else
  584. data->sensors[attr->index].data = regval;
  585. mutex_unlock(&data->update_lock);
  586. return rv;
  587. }
  588. static ssize_t pmbus_show_label(struct device *dev,
  589. struct device_attribute *da, char *buf)
  590. {
  591. struct i2c_client *client = to_i2c_client(dev);
  592. struct pmbus_data *data = i2c_get_clientdata(client);
  593. struct sensor_device_attribute *attr = to_sensor_dev_attr(da);
  594. return snprintf(buf, PAGE_SIZE, "%s\n",
  595. data->labels[attr->index].label);
  596. }
  597. #define PMBUS_ADD_ATTR(data, _name, _idx, _mode, _type, _show, _set) \
  598. do { \
  599. struct sensor_device_attribute *a \
  600. = &data->_type##s[data->num_##_type##s].attribute; \
  601. BUG_ON(data->num_attributes >= data->max_attributes); \
  602. a->dev_attr.attr.name = _name; \
  603. a->dev_attr.attr.mode = _mode; \
  604. a->dev_attr.show = _show; \
  605. a->dev_attr.store = _set; \
  606. a->index = _idx; \
  607. data->attributes[data->num_attributes] = &a->dev_attr.attr; \
  608. data->num_attributes++; \
  609. } while (0)
  610. #define PMBUS_ADD_GET_ATTR(data, _name, _type, _idx) \
  611. PMBUS_ADD_ATTR(data, _name, _idx, S_IRUGO, _type, \
  612. pmbus_show_##_type, NULL)
  613. #define PMBUS_ADD_SET_ATTR(data, _name, _type, _idx) \
  614. PMBUS_ADD_ATTR(data, _name, _idx, S_IWUSR | S_IRUGO, _type, \
  615. pmbus_show_##_type, pmbus_set_##_type)
  616. static void pmbus_add_boolean(struct pmbus_data *data,
  617. const char *name, const char *type, int seq,
  618. int idx)
  619. {
  620. struct pmbus_boolean *boolean;
  621. BUG_ON(data->num_booleans >= data->max_booleans);
  622. boolean = &data->booleans[data->num_booleans];
  623. snprintf(boolean->name, sizeof(boolean->name), "%s%d_%s",
  624. name, seq, type);
  625. PMBUS_ADD_GET_ATTR(data, boolean->name, boolean, idx);
  626. data->num_booleans++;
  627. }
  628. static void pmbus_add_boolean_reg(struct pmbus_data *data,
  629. const char *name, const char *type,
  630. int seq, int reg, int bit)
  631. {
  632. pmbus_add_boolean(data, name, type, seq, (reg << 8) | bit);
  633. }
  634. static void pmbus_add_boolean_cmp(struct pmbus_data *data,
  635. const char *name, const char *type,
  636. int seq, int i1, int i2, int reg, int mask)
  637. {
  638. pmbus_add_boolean(data, name, type, seq,
  639. (i1 << 24) | (i2 << 16) | (reg << 8) | mask);
  640. }
  641. static void pmbus_add_sensor(struct pmbus_data *data,
  642. const char *name, const char *type, int seq,
  643. int page, int reg, enum pmbus_sensor_classes class,
  644. bool update, bool readonly)
  645. {
  646. struct pmbus_sensor *sensor;
  647. BUG_ON(data->num_sensors >= data->max_sensors);
  648. sensor = &data->sensors[data->num_sensors];
  649. snprintf(sensor->name, sizeof(sensor->name), "%s%d_%s",
  650. name, seq, type);
  651. sensor->page = page;
  652. sensor->reg = reg;
  653. sensor->class = class;
  654. sensor->update = update;
  655. if (readonly)
  656. PMBUS_ADD_GET_ATTR(data, sensor->name, sensor,
  657. data->num_sensors);
  658. else
  659. PMBUS_ADD_SET_ATTR(data, sensor->name, sensor,
  660. data->num_sensors);
  661. data->num_sensors++;
  662. }
  663. static void pmbus_add_label(struct pmbus_data *data,
  664. const char *name, int seq,
  665. const char *lstring, int index)
  666. {
  667. struct pmbus_label *label;
  668. BUG_ON(data->num_labels >= data->max_labels);
  669. label = &data->labels[data->num_labels];
  670. snprintf(label->name, sizeof(label->name), "%s%d_label", name, seq);
  671. if (!index)
  672. strncpy(label->label, lstring, sizeof(label->label) - 1);
  673. else
  674. snprintf(label->label, sizeof(label->label), "%s%d", lstring,
  675. index);
  676. PMBUS_ADD_GET_ATTR(data, label->name, label, data->num_labels);
  677. data->num_labels++;
  678. }
  679. /*
  680. * Determine maximum number of sensors, booleans, and labels.
  681. * To keep things simple, only make a rough high estimate.
  682. */
  683. static void pmbus_find_max_attr(struct i2c_client *client,
  684. struct pmbus_data *data)
  685. {
  686. const struct pmbus_driver_info *info = data->info;
  687. int page, max_sensors, max_booleans, max_labels;
  688. max_sensors = PMBUS_MAX_INPUT_SENSORS;
  689. max_booleans = PMBUS_MAX_INPUT_BOOLEANS;
  690. max_labels = PMBUS_MAX_INPUT_LABELS;
  691. for (page = 0; page < info->pages; page++) {
  692. if (info->func[page] & PMBUS_HAVE_VOUT) {
  693. max_sensors += PMBUS_VOUT_SENSORS_PER_PAGE;
  694. max_booleans += PMBUS_VOUT_BOOLEANS_PER_PAGE;
  695. max_labels++;
  696. }
  697. if (info->func[page] & PMBUS_HAVE_IOUT) {
  698. max_sensors += PMBUS_IOUT_SENSORS_PER_PAGE;
  699. max_booleans += PMBUS_IOUT_BOOLEANS_PER_PAGE;
  700. max_labels++;
  701. }
  702. if (info->func[page] & PMBUS_HAVE_POUT) {
  703. max_sensors += PMBUS_POUT_SENSORS_PER_PAGE;
  704. max_booleans += PMBUS_POUT_BOOLEANS_PER_PAGE;
  705. max_labels++;
  706. }
  707. if (info->func[page] & PMBUS_HAVE_FAN12) {
  708. max_sensors += 2 * PMBUS_MAX_SENSORS_PER_FAN;
  709. max_booleans += 2 * PMBUS_MAX_BOOLEANS_PER_FAN;
  710. }
  711. if (info->func[page] & PMBUS_HAVE_FAN34) {
  712. max_sensors += 2 * PMBUS_MAX_SENSORS_PER_FAN;
  713. max_booleans += 2 * PMBUS_MAX_BOOLEANS_PER_FAN;
  714. }
  715. if (info->func[page] & PMBUS_HAVE_TEMP) {
  716. max_sensors += PMBUS_MAX_SENSORS_PER_TEMP;
  717. max_booleans += PMBUS_MAX_BOOLEANS_PER_TEMP;
  718. }
  719. if (info->func[page] & PMBUS_HAVE_TEMP2) {
  720. max_sensors += PMBUS_MAX_SENSORS_PER_TEMP;
  721. max_booleans += PMBUS_MAX_BOOLEANS_PER_TEMP;
  722. }
  723. if (info->func[page] & PMBUS_HAVE_TEMP3) {
  724. max_sensors += PMBUS_MAX_SENSORS_PER_TEMP;
  725. max_booleans += PMBUS_MAX_BOOLEANS_PER_TEMP;
  726. }
  727. }
  728. data->max_sensors = max_sensors;
  729. data->max_booleans = max_booleans;
  730. data->max_labels = max_labels;
  731. data->max_attributes = max_sensors + max_booleans + max_labels;
  732. }
  733. /*
  734. * Search for attributes. Allocate sensors, booleans, and labels as needed.
  735. */
  736. /*
  737. * The pmbus_limit_attr structure describes a single limit attribute
  738. * and its associated alarm attribute.
  739. */
  740. struct pmbus_limit_attr {
  741. u8 reg; /* Limit register */
  742. const char *attr; /* Attribute name */
  743. const char *alarm; /* Alarm attribute name */
  744. u32 sbit; /* Alarm attribute status bit */
  745. };
  746. /*
  747. * The pmbus_sensor_attr structure describes one sensor attribute. This
  748. * description includes a reference to the associated limit attributes.
  749. */
  750. struct pmbus_sensor_attr {
  751. u8 reg; /* sensor register */
  752. enum pmbus_sensor_classes class;/* sensor class */
  753. const char *label; /* sensor label */
  754. bool paged; /* true if paged sensor */
  755. bool update; /* true if update needed */
  756. bool compare; /* true if compare function needed */
  757. u32 func; /* sensor mask */
  758. u32 sfunc; /* sensor status mask */
  759. int sbase; /* status base register */
  760. u32 gbit; /* generic status bit */
  761. const struct pmbus_limit_attr *limit;/* limit registers */
  762. int nlimit; /* # of limit registers */
  763. };
  764. /*
  765. * Add a set of limit attributes and, if supported, the associated
  766. * alarm attributes.
  767. */
  768. static bool pmbus_add_limit_attrs(struct i2c_client *client,
  769. struct pmbus_data *data,
  770. const struct pmbus_driver_info *info,
  771. const char *name, int index, int page,
  772. int cbase,
  773. const struct pmbus_sensor_attr *attr)
  774. {
  775. const struct pmbus_limit_attr *l = attr->limit;
  776. int nlimit = attr->nlimit;
  777. bool have_alarm = false;
  778. int i, cindex;
  779. for (i = 0; i < nlimit; i++) {
  780. if (pmbus_check_word_register(client, page, l->reg)) {
  781. cindex = data->num_sensors;
  782. pmbus_add_sensor(data, name, l->attr, index, page,
  783. l->reg, attr->class, attr->update,
  784. false);
  785. if (info->func[page] & attr->sfunc) {
  786. if (attr->compare) {
  787. pmbus_add_boolean_cmp(data, name,
  788. l->alarm, index,
  789. cbase, cindex,
  790. attr->sbase + page, l->sbit);
  791. } else {
  792. pmbus_add_boolean_reg(data, name,
  793. l->alarm, index,
  794. attr->sbase + page, l->sbit);
  795. }
  796. have_alarm = true;
  797. }
  798. }
  799. l++;
  800. }
  801. return have_alarm;
  802. }
  803. static void pmbus_add_sensor_attrs_one(struct i2c_client *client,
  804. struct pmbus_data *data,
  805. const struct pmbus_driver_info *info,
  806. const char *name,
  807. int index, int page,
  808. const struct pmbus_sensor_attr *attr)
  809. {
  810. bool have_alarm;
  811. int cbase = data->num_sensors;
  812. if (attr->label)
  813. pmbus_add_label(data, name, index, attr->label,
  814. attr->paged ? page + 1 : 0);
  815. pmbus_add_sensor(data, name, "input", index, page, attr->reg,
  816. attr->class, true, true);
  817. if (attr->sfunc) {
  818. have_alarm = pmbus_add_limit_attrs(client, data, info, name,
  819. index, page, cbase, attr);
  820. /*
  821. * Add generic alarm attribute only if there are no individual
  822. * alarm attributes, and if there is a global alarm bit.
  823. */
  824. if (!have_alarm && attr->gbit)
  825. pmbus_add_boolean_reg(data, name, "alarm", index,
  826. PB_STATUS_BASE + page,
  827. attr->gbit);
  828. }
  829. }
  830. static void pmbus_add_sensor_attrs(struct i2c_client *client,
  831. struct pmbus_data *data,
  832. const char *name,
  833. const struct pmbus_sensor_attr *attrs,
  834. int nattrs)
  835. {
  836. const struct pmbus_driver_info *info = data->info;
  837. int index, i;
  838. index = 1;
  839. for (i = 0; i < nattrs; i++) {
  840. int page, pages;
  841. pages = attrs->paged ? info->pages : 1;
  842. for (page = 0; page < pages; page++) {
  843. if (!(info->func[page] & attrs->func))
  844. continue;
  845. pmbus_add_sensor_attrs_one(client, data, info, name,
  846. index, page, attrs);
  847. index++;
  848. }
  849. attrs++;
  850. }
  851. }
  852. static const struct pmbus_limit_attr vin_limit_attrs[] = {
  853. {
  854. .reg = PMBUS_VIN_UV_WARN_LIMIT,
  855. .attr = "min",
  856. .alarm = "min_alarm",
  857. .sbit = PB_VOLTAGE_UV_WARNING,
  858. }, {
  859. .reg = PMBUS_VIN_UV_FAULT_LIMIT,
  860. .attr = "lcrit",
  861. .alarm = "lcrit_alarm",
  862. .sbit = PB_VOLTAGE_UV_FAULT,
  863. }, {
  864. .reg = PMBUS_VIN_OV_WARN_LIMIT,
  865. .attr = "max",
  866. .alarm = "max_alarm",
  867. .sbit = PB_VOLTAGE_OV_WARNING,
  868. }, {
  869. .reg = PMBUS_VIN_OV_FAULT_LIMIT,
  870. .attr = "crit",
  871. .alarm = "crit_alarm",
  872. .sbit = PB_VOLTAGE_OV_FAULT,
  873. },
  874. };
  875. static const struct pmbus_limit_attr vout_limit_attrs[] = {
  876. {
  877. .reg = PMBUS_VOUT_UV_WARN_LIMIT,
  878. .attr = "min",
  879. .alarm = "min_alarm",
  880. .sbit = PB_VOLTAGE_UV_WARNING,
  881. }, {
  882. .reg = PMBUS_VOUT_UV_FAULT_LIMIT,
  883. .attr = "lcrit",
  884. .alarm = "lcrit_alarm",
  885. .sbit = PB_VOLTAGE_UV_FAULT,
  886. }, {
  887. .reg = PMBUS_VOUT_OV_WARN_LIMIT,
  888. .attr = "max",
  889. .alarm = "max_alarm",
  890. .sbit = PB_VOLTAGE_OV_WARNING,
  891. }, {
  892. .reg = PMBUS_VOUT_OV_FAULT_LIMIT,
  893. .attr = "crit",
  894. .alarm = "crit_alarm",
  895. .sbit = PB_VOLTAGE_OV_FAULT,
  896. }
  897. };
  898. static const struct pmbus_sensor_attr voltage_attributes[] = {
  899. {
  900. .reg = PMBUS_READ_VIN,
  901. .class = PSC_VOLTAGE_IN,
  902. .label = "vin",
  903. .func = PMBUS_HAVE_VIN,
  904. .sfunc = PMBUS_HAVE_STATUS_INPUT,
  905. .sbase = PB_STATUS_INPUT_BASE,
  906. .gbit = PB_STATUS_VIN_UV,
  907. .limit = vin_limit_attrs,
  908. .nlimit = ARRAY_SIZE(vin_limit_attrs),
  909. }, {
  910. .reg = PMBUS_READ_VCAP,
  911. .class = PSC_VOLTAGE_IN,
  912. .label = "vcap",
  913. .func = PMBUS_HAVE_VCAP,
  914. }, {
  915. .reg = PMBUS_READ_VOUT,
  916. .class = PSC_VOLTAGE_OUT,
  917. .label = "vout",
  918. .paged = true,
  919. .func = PMBUS_HAVE_VOUT,
  920. .sfunc = PMBUS_HAVE_STATUS_VOUT,
  921. .sbase = PB_STATUS_VOUT_BASE,
  922. .gbit = PB_STATUS_VOUT_OV,
  923. .limit = vout_limit_attrs,
  924. .nlimit = ARRAY_SIZE(vout_limit_attrs),
  925. }
  926. };
  927. /* Current attributes */
  928. static const struct pmbus_limit_attr iin_limit_attrs[] = {
  929. {
  930. .reg = PMBUS_IIN_OC_WARN_LIMIT,
  931. .attr = "max",
  932. .alarm = "max_alarm",
  933. .sbit = PB_IIN_OC_WARNING,
  934. }, {
  935. .reg = PMBUS_IIN_OC_FAULT_LIMIT,
  936. .attr = "crit",
  937. .alarm = "crit_alarm",
  938. .sbit = PB_IIN_OC_FAULT,
  939. }
  940. };
  941. static const struct pmbus_limit_attr iout_limit_attrs[] = {
  942. {
  943. .reg = PMBUS_IOUT_OC_WARN_LIMIT,
  944. .attr = "max",
  945. .alarm = "max_alarm",
  946. .sbit = PB_IOUT_OC_WARNING,
  947. }, {
  948. .reg = PMBUS_IOUT_UC_FAULT_LIMIT,
  949. .attr = "lcrit",
  950. .alarm = "lcrit_alarm",
  951. .sbit = PB_IOUT_UC_FAULT,
  952. }, {
  953. .reg = PMBUS_IOUT_OC_FAULT_LIMIT,
  954. .attr = "crit",
  955. .alarm = "crit_alarm",
  956. .sbit = PB_IOUT_OC_FAULT,
  957. }
  958. };
  959. static const struct pmbus_sensor_attr current_attributes[] = {
  960. {
  961. .reg = PMBUS_READ_IIN,
  962. .class = PSC_CURRENT_IN,
  963. .label = "iin",
  964. .func = PMBUS_HAVE_IIN,
  965. .sfunc = PMBUS_HAVE_STATUS_INPUT,
  966. .sbase = PB_STATUS_INPUT_BASE,
  967. .limit = iin_limit_attrs,
  968. .nlimit = ARRAY_SIZE(iin_limit_attrs),
  969. }, {
  970. .reg = PMBUS_READ_IOUT,
  971. .class = PSC_CURRENT_OUT,
  972. .label = "iout",
  973. .paged = true,
  974. .func = PMBUS_HAVE_IOUT,
  975. .sfunc = PMBUS_HAVE_STATUS_IOUT,
  976. .sbase = PB_STATUS_IOUT_BASE,
  977. .gbit = PB_STATUS_IOUT_OC,
  978. .limit = iout_limit_attrs,
  979. .nlimit = ARRAY_SIZE(iout_limit_attrs),
  980. }
  981. };
  982. /* Power attributes */
  983. static const struct pmbus_limit_attr pin_limit_attrs[] = {
  984. {
  985. .reg = PMBUS_PIN_OP_WARN_LIMIT,
  986. .attr = "max",
  987. .alarm = "alarm",
  988. .sbit = PB_PIN_OP_WARNING,
  989. }
  990. };
  991. static const struct pmbus_limit_attr pout_limit_attrs[] = {
  992. {
  993. .reg = PMBUS_POUT_MAX,
  994. .attr = "cap",
  995. .alarm = "cap_alarm",
  996. .sbit = PB_POWER_LIMITING,
  997. }, {
  998. .reg = PMBUS_POUT_OP_WARN_LIMIT,
  999. .attr = "max",
  1000. .alarm = "max_alarm",
  1001. .sbit = PB_POUT_OP_WARNING,
  1002. }, {
  1003. .reg = PMBUS_POUT_OP_FAULT_LIMIT,
  1004. .attr = "crit",
  1005. .alarm = "crit_alarm",
  1006. .sbit = PB_POUT_OP_FAULT,
  1007. }
  1008. };
  1009. static const struct pmbus_sensor_attr power_attributes[] = {
  1010. {
  1011. .reg = PMBUS_READ_PIN,
  1012. .class = PSC_POWER,
  1013. .label = "pin",
  1014. .func = PMBUS_HAVE_PIN,
  1015. .sfunc = PMBUS_HAVE_STATUS_INPUT,
  1016. .sbase = PB_STATUS_INPUT_BASE,
  1017. .limit = pin_limit_attrs,
  1018. .nlimit = ARRAY_SIZE(pin_limit_attrs),
  1019. }, {
  1020. .reg = PMBUS_READ_POUT,
  1021. .class = PSC_POWER,
  1022. .label = "pout",
  1023. .paged = true,
  1024. .func = PMBUS_HAVE_POUT,
  1025. .sfunc = PMBUS_HAVE_STATUS_IOUT,
  1026. .sbase = PB_STATUS_IOUT_BASE,
  1027. .limit = pout_limit_attrs,
  1028. .nlimit = ARRAY_SIZE(pout_limit_attrs),
  1029. }
  1030. };
  1031. /* Temperature atributes */
  1032. static const struct pmbus_limit_attr temp_limit_attrs[] = {
  1033. {
  1034. .reg = PMBUS_UT_WARN_LIMIT,
  1035. .attr = "min",
  1036. .alarm = "min_alarm",
  1037. .sbit = PB_TEMP_UT_WARNING,
  1038. }, {
  1039. .reg = PMBUS_UT_FAULT_LIMIT,
  1040. .attr = "lcrit",
  1041. .alarm = "lcrit_alarm",
  1042. .sbit = PB_TEMP_UT_FAULT,
  1043. }, {
  1044. .reg = PMBUS_OT_WARN_LIMIT,
  1045. .attr = "max",
  1046. .alarm = "max_alarm",
  1047. .sbit = PB_TEMP_OT_WARNING,
  1048. }, {
  1049. .reg = PMBUS_OT_FAULT_LIMIT,
  1050. .attr = "crit",
  1051. .alarm = "crit_alarm",
  1052. .sbit = PB_TEMP_OT_FAULT,
  1053. }
  1054. };
  1055. static const struct pmbus_sensor_attr temp_attributes[] = {
  1056. {
  1057. .reg = PMBUS_READ_TEMPERATURE_1,
  1058. .class = PSC_TEMPERATURE,
  1059. .paged = true,
  1060. .update = true,
  1061. .compare = true,
  1062. .func = PMBUS_HAVE_TEMP,
  1063. .sfunc = PMBUS_HAVE_STATUS_TEMP,
  1064. .sbase = PB_STATUS_TEMP_BASE,
  1065. .gbit = PB_STATUS_TEMPERATURE,
  1066. .limit = temp_limit_attrs,
  1067. .nlimit = ARRAY_SIZE(temp_limit_attrs),
  1068. }, {
  1069. .reg = PMBUS_READ_TEMPERATURE_2,
  1070. .class = PSC_TEMPERATURE,
  1071. .paged = true,
  1072. .update = true,
  1073. .compare = true,
  1074. .func = PMBUS_HAVE_TEMP2,
  1075. .sfunc = PMBUS_HAVE_STATUS_TEMP,
  1076. .sbase = PB_STATUS_TEMP_BASE,
  1077. .gbit = PB_STATUS_TEMPERATURE,
  1078. .limit = temp_limit_attrs,
  1079. .nlimit = ARRAY_SIZE(temp_limit_attrs),
  1080. }, {
  1081. .reg = PMBUS_READ_TEMPERATURE_3,
  1082. .class = PSC_TEMPERATURE,
  1083. .paged = true,
  1084. .update = true,
  1085. .compare = true,
  1086. .func = PMBUS_HAVE_TEMP3,
  1087. .sfunc = PMBUS_HAVE_STATUS_TEMP,
  1088. .sbase = PB_STATUS_TEMP_BASE,
  1089. .gbit = PB_STATUS_TEMPERATURE,
  1090. .limit = temp_limit_attrs,
  1091. .nlimit = ARRAY_SIZE(temp_limit_attrs),
  1092. }
  1093. };
  1094. static const int pmbus_fan_registers[] = {
  1095. PMBUS_READ_FAN_SPEED_1,
  1096. PMBUS_READ_FAN_SPEED_2,
  1097. PMBUS_READ_FAN_SPEED_3,
  1098. PMBUS_READ_FAN_SPEED_4
  1099. };
  1100. static const int pmbus_fan_config_registers[] = {
  1101. PMBUS_FAN_CONFIG_12,
  1102. PMBUS_FAN_CONFIG_12,
  1103. PMBUS_FAN_CONFIG_34,
  1104. PMBUS_FAN_CONFIG_34
  1105. };
  1106. static const int pmbus_fan_status_registers[] = {
  1107. PMBUS_STATUS_FAN_12,
  1108. PMBUS_STATUS_FAN_12,
  1109. PMBUS_STATUS_FAN_34,
  1110. PMBUS_STATUS_FAN_34
  1111. };
  1112. static const u32 pmbus_fan_flags[] = {
  1113. PMBUS_HAVE_FAN12,
  1114. PMBUS_HAVE_FAN12,
  1115. PMBUS_HAVE_FAN34,
  1116. PMBUS_HAVE_FAN34
  1117. };
  1118. static const u32 pmbus_fan_status_flags[] = {
  1119. PMBUS_HAVE_STATUS_FAN12,
  1120. PMBUS_HAVE_STATUS_FAN12,
  1121. PMBUS_HAVE_STATUS_FAN34,
  1122. PMBUS_HAVE_STATUS_FAN34
  1123. };
  1124. /* Fans */
  1125. static void pmbus_add_fan_attributes(struct i2c_client *client,
  1126. struct pmbus_data *data)
  1127. {
  1128. const struct pmbus_driver_info *info = data->info;
  1129. int index = 1;
  1130. int page;
  1131. for (page = 0; page < info->pages; page++) {
  1132. int f;
  1133. for (f = 0; f < ARRAY_SIZE(pmbus_fan_registers); f++) {
  1134. int regval;
  1135. if (!(info->func[page] & pmbus_fan_flags[f]))
  1136. break;
  1137. if (!pmbus_check_word_register(client, page,
  1138. pmbus_fan_registers[f]))
  1139. break;
  1140. /*
  1141. * Skip fan if not installed.
  1142. * Each fan configuration register covers multiple fans,
  1143. * so we have to do some magic.
  1144. */
  1145. regval = _pmbus_read_byte_data(client, page,
  1146. pmbus_fan_config_registers[f]);
  1147. if (regval < 0 ||
  1148. (!(regval & (PB_FAN_1_INSTALLED >> ((f & 1) * 4)))))
  1149. continue;
  1150. pmbus_add_sensor(data, "fan", "input", index, page,
  1151. pmbus_fan_registers[f], PSC_FAN, true,
  1152. true);
  1153. /*
  1154. * Each fan status register covers multiple fans,
  1155. * so we have to do some magic.
  1156. */
  1157. if ((info->func[page] & pmbus_fan_status_flags[f]) &&
  1158. pmbus_check_byte_register(client,
  1159. page, pmbus_fan_status_registers[f])) {
  1160. int base;
  1161. if (f > 1) /* fan 3, 4 */
  1162. base = PB_STATUS_FAN34_BASE + page;
  1163. else
  1164. base = PB_STATUS_FAN_BASE + page;
  1165. pmbus_add_boolean_reg(data, "fan", "alarm",
  1166. index, base,
  1167. PB_FAN_FAN1_WARNING >> (f & 1));
  1168. pmbus_add_boolean_reg(data, "fan", "fault",
  1169. index, base,
  1170. PB_FAN_FAN1_FAULT >> (f & 1));
  1171. }
  1172. index++;
  1173. }
  1174. }
  1175. }
  1176. static void pmbus_find_attributes(struct i2c_client *client,
  1177. struct pmbus_data *data)
  1178. {
  1179. /* Voltage sensors */
  1180. pmbus_add_sensor_attrs(client, data, "in", voltage_attributes,
  1181. ARRAY_SIZE(voltage_attributes));
  1182. /* Current sensors */
  1183. pmbus_add_sensor_attrs(client, data, "curr", current_attributes,
  1184. ARRAY_SIZE(current_attributes));
  1185. /* Power sensors */
  1186. pmbus_add_sensor_attrs(client, data, "power", power_attributes,
  1187. ARRAY_SIZE(power_attributes));
  1188. /* Temperature sensors */
  1189. pmbus_add_sensor_attrs(client, data, "temp", temp_attributes,
  1190. ARRAY_SIZE(temp_attributes));
  1191. /* Fans */
  1192. pmbus_add_fan_attributes(client, data);
  1193. }
  1194. /*
  1195. * Identify chip parameters.
  1196. * This function is called for all chips.
  1197. */
  1198. static int pmbus_identify_common(struct i2c_client *client,
  1199. struct pmbus_data *data)
  1200. {
  1201. int vout_mode = -1, exponent;
  1202. if (pmbus_check_byte_register(client, 0, PMBUS_VOUT_MODE))
  1203. vout_mode = pmbus_read_byte_data(client, 0, PMBUS_VOUT_MODE);
  1204. if (vout_mode >= 0 && vout_mode != 0xff) {
  1205. /*
  1206. * Not all chips support the VOUT_MODE command,
  1207. * so a failure to read it is not an error.
  1208. */
  1209. switch (vout_mode >> 5) {
  1210. case 0: /* linear mode */
  1211. if (data->info->direct[PSC_VOLTAGE_OUT])
  1212. return -ENODEV;
  1213. exponent = vout_mode & 0x1f;
  1214. /* and sign-extend it */
  1215. if (exponent & 0x10)
  1216. exponent |= ~0x1f;
  1217. data->exponent = exponent;
  1218. break;
  1219. case 2: /* direct mode */
  1220. if (!data->info->direct[PSC_VOLTAGE_OUT])
  1221. return -ENODEV;
  1222. break;
  1223. default:
  1224. return -ENODEV;
  1225. }
  1226. }
  1227. /* Determine maximum number of sensors, booleans, and labels */
  1228. pmbus_find_max_attr(client, data);
  1229. pmbus_clear_fault_page(client, 0);
  1230. return 0;
  1231. }
  1232. int pmbus_do_probe(struct i2c_client *client, const struct i2c_device_id *id,
  1233. struct pmbus_driver_info *info)
  1234. {
  1235. const struct pmbus_platform_data *pdata = client->dev.platform_data;
  1236. struct pmbus_data *data;
  1237. int ret;
  1238. if (!info) {
  1239. dev_err(&client->dev, "Missing chip information");
  1240. return -ENODEV;
  1241. }
  1242. if (!i2c_check_functionality(client->adapter, I2C_FUNC_SMBUS_WRITE_BYTE
  1243. | I2C_FUNC_SMBUS_BYTE_DATA
  1244. | I2C_FUNC_SMBUS_WORD_DATA))
  1245. return -ENODEV;
  1246. data = kzalloc(sizeof(*data), GFP_KERNEL);
  1247. if (!data) {
  1248. dev_err(&client->dev, "No memory to allocate driver data\n");
  1249. return -ENOMEM;
  1250. }
  1251. i2c_set_clientdata(client, data);
  1252. mutex_init(&data->update_lock);
  1253. /*
  1254. * Bail out if status register or PMBus revision register
  1255. * does not exist.
  1256. */
  1257. if (i2c_smbus_read_byte_data(client, PMBUS_STATUS_BYTE) < 0
  1258. || i2c_smbus_read_byte_data(client, PMBUS_REVISION) < 0) {
  1259. dev_err(&client->dev,
  1260. "Status or revision register not found\n");
  1261. ret = -ENODEV;
  1262. goto out_data;
  1263. }
  1264. if (pdata)
  1265. data->flags = pdata->flags;
  1266. data->info = info;
  1267. pmbus_clear_faults(client);
  1268. if (info->identify) {
  1269. ret = (*info->identify)(client, info);
  1270. if (ret < 0) {
  1271. dev_err(&client->dev, "Chip identification failed\n");
  1272. goto out_data;
  1273. }
  1274. }
  1275. if (info->pages <= 0 || info->pages > PMBUS_PAGES) {
  1276. dev_err(&client->dev, "Bad number of PMBus pages: %d\n",
  1277. info->pages);
  1278. ret = -EINVAL;
  1279. goto out_data;
  1280. }
  1281. /*
  1282. * Bail out if more than one page was configured, but we can not
  1283. * select the highest page. This is an indication that the wrong
  1284. * chip type was selected. Better bail out now than keep
  1285. * returning errors later on.
  1286. */
  1287. if (info->pages > 1 && pmbus_set_page(client, info->pages - 1) < 0) {
  1288. dev_err(&client->dev, "Failed to select page %d\n",
  1289. info->pages - 1);
  1290. ret = -EINVAL;
  1291. goto out_data;
  1292. }
  1293. ret = pmbus_identify_common(client, data);
  1294. if (ret < 0) {
  1295. dev_err(&client->dev, "Failed to identify chip capabilities\n");
  1296. goto out_data;
  1297. }
  1298. ret = -ENOMEM;
  1299. data->sensors = kzalloc(sizeof(struct pmbus_sensor) * data->max_sensors,
  1300. GFP_KERNEL);
  1301. if (!data->sensors) {
  1302. dev_err(&client->dev, "No memory to allocate sensor data\n");
  1303. goto out_data;
  1304. }
  1305. data->booleans = kzalloc(sizeof(struct pmbus_boolean)
  1306. * data->max_booleans, GFP_KERNEL);
  1307. if (!data->booleans) {
  1308. dev_err(&client->dev, "No memory to allocate boolean data\n");
  1309. goto out_sensors;
  1310. }
  1311. data->labels = kzalloc(sizeof(struct pmbus_label) * data->max_labels,
  1312. GFP_KERNEL);
  1313. if (!data->labels) {
  1314. dev_err(&client->dev, "No memory to allocate label data\n");
  1315. goto out_booleans;
  1316. }
  1317. data->attributes = kzalloc(sizeof(struct attribute *)
  1318. * data->max_attributes, GFP_KERNEL);
  1319. if (!data->attributes) {
  1320. dev_err(&client->dev, "No memory to allocate attribute data\n");
  1321. goto out_labels;
  1322. }
  1323. pmbus_find_attributes(client, data);
  1324. /*
  1325. * If there are no attributes, something is wrong.
  1326. * Bail out instead of trying to register nothing.
  1327. */
  1328. if (!data->num_attributes) {
  1329. dev_err(&client->dev, "No attributes found\n");
  1330. ret = -ENODEV;
  1331. goto out_attributes;
  1332. }
  1333. /* Register sysfs hooks */
  1334. data->group.attrs = data->attributes;
  1335. ret = sysfs_create_group(&client->dev.kobj, &data->group);
  1336. if (ret) {
  1337. dev_err(&client->dev, "Failed to create sysfs entries\n");
  1338. goto out_attributes;
  1339. }
  1340. data->hwmon_dev = hwmon_device_register(&client->dev);
  1341. if (IS_ERR(data->hwmon_dev)) {
  1342. ret = PTR_ERR(data->hwmon_dev);
  1343. dev_err(&client->dev, "Failed to register hwmon device\n");
  1344. goto out_hwmon_device_register;
  1345. }
  1346. return 0;
  1347. out_hwmon_device_register:
  1348. sysfs_remove_group(&client->dev.kobj, &data->group);
  1349. out_attributes:
  1350. kfree(data->attributes);
  1351. out_labels:
  1352. kfree(data->labels);
  1353. out_booleans:
  1354. kfree(data->booleans);
  1355. out_sensors:
  1356. kfree(data->sensors);
  1357. out_data:
  1358. kfree(data);
  1359. return ret;
  1360. }
  1361. EXPORT_SYMBOL_GPL(pmbus_do_probe);
  1362. int pmbus_do_remove(struct i2c_client *client)
  1363. {
  1364. struct pmbus_data *data = i2c_get_clientdata(client);
  1365. hwmon_device_unregister(data->hwmon_dev);
  1366. sysfs_remove_group(&client->dev.kobj, &data->group);
  1367. kfree(data->attributes);
  1368. kfree(data->labels);
  1369. kfree(data->booleans);
  1370. kfree(data->sensors);
  1371. kfree(data);
  1372. return 0;
  1373. }
  1374. EXPORT_SYMBOL_GPL(pmbus_do_remove);
  1375. MODULE_AUTHOR("Guenter Roeck");
  1376. MODULE_DESCRIPTION("PMBus core driver");
  1377. MODULE_LICENSE("GPL");