pmbus_core.c 44 KB

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