pmbus_core.c 45 KB

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