1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Hardware monitoring driver for PMBus devices
5 * Copyright (c) 2010, 2011 Ericsson AB.
6 * Copyright (c) 2012 Guenter Roeck
9 #include <linux/debugfs.h>
10 #include <linux/kernel.h>
11 #include <linux/math64.h>
12 #include <linux/module.h>
13 #include <linux/init.h>
14 #include <linux/err.h>
15 #include <linux/slab.h>
16 #include <linux/i2c.h>
17 #include <linux/hwmon.h>
18 #include <linux/hwmon-sysfs.h>
19 #include <linux/pmbus.h>
20 #include <linux/regulator/driver.h>
21 #include <linux/regulator/machine.h>
23 #include <linux/thermal.h>
27 * Number of additional attribute pointers to allocate
28 * with each call to krealloc
30 #define PMBUS_ATTR_ALLOC_SIZE 32
31 #define PMBUS_NAME_SIZE 24
34 struct pmbus_sensor *next;
35 char name[PMBUS_NAME_SIZE]; /* sysfs sensor name */
36 struct device_attribute attribute;
37 u8 page; /* page number */
38 u8 phase; /* phase number, 0xff for all phases */
39 u16 reg; /* register */
40 enum pmbus_sensor_classes class; /* sensor class */
41 bool update; /* runtime sensor update needed */
42 bool convert; /* Whether or not to apply linear/vid/direct */
43 int data; /* Sensor data.
44 Negative if there was a read error */
46 #define to_pmbus_sensor(_attr) \
47 container_of(_attr, struct pmbus_sensor, attribute)
49 struct pmbus_boolean {
50 char name[PMBUS_NAME_SIZE]; /* sysfs boolean name */
51 struct sensor_device_attribute attribute;
52 struct pmbus_sensor *s1;
53 struct pmbus_sensor *s2;
55 #define to_pmbus_boolean(_attr) \
56 container_of(_attr, struct pmbus_boolean, attribute)
59 char name[PMBUS_NAME_SIZE]; /* sysfs label name */
60 struct device_attribute attribute;
61 char label[PMBUS_NAME_SIZE]; /* label */
63 #define to_pmbus_label(_attr) \
64 container_of(_attr, struct pmbus_label, attribute)
66 /* Macros for converting between sensor index and register/page/status mask */
68 #define PB_STATUS_MASK 0xffff
69 #define PB_REG_SHIFT 16
70 #define PB_REG_MASK 0x3ff
71 #define PB_PAGE_SHIFT 26
72 #define PB_PAGE_MASK 0x3f
74 #define pb_reg_to_index(page, reg, mask) (((page) << PB_PAGE_SHIFT) | \
75 ((reg) << PB_REG_SHIFT) | (mask))
77 #define pb_index_to_page(index) (((index) >> PB_PAGE_SHIFT) & PB_PAGE_MASK)
78 #define pb_index_to_reg(index) (((index) >> PB_REG_SHIFT) & PB_REG_MASK)
79 #define pb_index_to_mask(index) ((index) & PB_STATUS_MASK)
83 struct device *hwmon_dev;
84 struct regulator_dev **rdevs;
86 u32 flags; /* from platform data */
88 int exponent[PMBUS_PAGES];
89 /* linear mode: exponent for output voltages */
91 const struct pmbus_driver_info *info;
95 struct attribute_group group;
96 const struct attribute_group **groups;
97 struct dentry *debugfs; /* debugfs device directory */
99 struct pmbus_sensor *sensors;
101 struct mutex update_lock;
103 bool has_status_word; /* device uses STATUS_WORD register */
104 int (*read_status)(struct i2c_client *client, int page);
106 s16 currpage; /* current page, -1 for unknown/unset */
107 s16 currphase; /* current phase, 0xff for all, -1 for unknown/unset */
109 int vout_low[PMBUS_PAGES]; /* voltage low margin */
110 int vout_high[PMBUS_PAGES]; /* voltage high margin */
113 struct pmbus_debugfs_entry {
114 struct i2c_client *client;
119 static const int pmbus_fan_rpm_mask[] = {
126 static const int pmbus_fan_config_registers[] = {
133 static const int pmbus_fan_command_registers[] = {
140 void pmbus_clear_cache(struct i2c_client *client)
142 struct pmbus_data *data = i2c_get_clientdata(client);
143 struct pmbus_sensor *sensor;
145 for (sensor = data->sensors; sensor; sensor = sensor->next)
146 sensor->data = -ENODATA;
148 EXPORT_SYMBOL_NS_GPL(pmbus_clear_cache, PMBUS);
150 void pmbus_set_update(struct i2c_client *client, u8 reg, bool update)
152 struct pmbus_data *data = i2c_get_clientdata(client);
153 struct pmbus_sensor *sensor;
155 for (sensor = data->sensors; sensor; sensor = sensor->next)
156 if (sensor->reg == reg)
157 sensor->update = update;
159 EXPORT_SYMBOL_NS_GPL(pmbus_set_update, PMBUS);
161 int pmbus_set_page(struct i2c_client *client, int page, int phase)
163 struct pmbus_data *data = i2c_get_clientdata(client);
169 if (!(data->info->func[page] & PMBUS_PAGE_VIRTUAL) &&
170 data->info->pages > 1 && page != data->currpage) {
171 rv = i2c_smbus_write_byte_data(client, PMBUS_PAGE, page);
175 rv = i2c_smbus_read_byte_data(client, PMBUS_PAGE);
182 data->currpage = page;
184 if (data->info->phases[page] && data->currphase != phase &&
185 !(data->info->func[page] & PMBUS_PHASE_VIRTUAL)) {
186 rv = i2c_smbus_write_byte_data(client, PMBUS_PHASE,
191 data->currphase = phase;
195 EXPORT_SYMBOL_NS_GPL(pmbus_set_page, PMBUS);
197 int pmbus_write_byte(struct i2c_client *client, int page, u8 value)
201 rv = pmbus_set_page(client, page, 0xff);
205 return i2c_smbus_write_byte(client, value);
207 EXPORT_SYMBOL_NS_GPL(pmbus_write_byte, PMBUS);
210 * _pmbus_write_byte() is similar to pmbus_write_byte(), but checks if
211 * a device specific mapping function exists and calls it if necessary.
213 static int _pmbus_write_byte(struct i2c_client *client, int page, u8 value)
215 struct pmbus_data *data = i2c_get_clientdata(client);
216 const struct pmbus_driver_info *info = data->info;
219 if (info->write_byte) {
220 status = info->write_byte(client, page, value);
221 if (status != -ENODATA)
224 return pmbus_write_byte(client, page, value);
227 int pmbus_write_word_data(struct i2c_client *client, int page, u8 reg,
232 rv = pmbus_set_page(client, page, 0xff);
236 return i2c_smbus_write_word_data(client, reg, word);
238 EXPORT_SYMBOL_NS_GPL(pmbus_write_word_data, PMBUS);
241 static int pmbus_write_virt_reg(struct i2c_client *client, int page, int reg,
249 case PMBUS_VIRT_FAN_TARGET_1 ... PMBUS_VIRT_FAN_TARGET_4:
250 id = reg - PMBUS_VIRT_FAN_TARGET_1;
251 bit = pmbus_fan_rpm_mask[id];
252 rv = pmbus_update_fan(client, page, id, bit, bit, word);
263 * _pmbus_write_word_data() is similar to pmbus_write_word_data(), but checks if
264 * a device specific mapping function exists and calls it if necessary.
266 static int _pmbus_write_word_data(struct i2c_client *client, int page, int reg,
269 struct pmbus_data *data = i2c_get_clientdata(client);
270 const struct pmbus_driver_info *info = data->info;
273 if (info->write_word_data) {
274 status = info->write_word_data(client, page, reg, word);
275 if (status != -ENODATA)
279 if (reg >= PMBUS_VIRT_BASE)
280 return pmbus_write_virt_reg(client, page, reg, word);
282 return pmbus_write_word_data(client, page, reg, word);
286 * _pmbus_write_byte_data() is similar to pmbus_write_byte_data(), but checks if
287 * a device specific mapping function exists and calls it if necessary.
289 static int _pmbus_write_byte_data(struct i2c_client *client, int page, int reg, u8 value)
291 struct pmbus_data *data = i2c_get_clientdata(client);
292 const struct pmbus_driver_info *info = data->info;
295 if (info->write_byte_data) {
296 status = info->write_byte_data(client, page, reg, value);
297 if (status != -ENODATA)
300 return pmbus_write_byte_data(client, page, reg, value);
304 * _pmbus_read_byte_data() is similar to pmbus_read_byte_data(), but checks if
305 * a device specific mapping function exists and calls it if necessary.
307 static int _pmbus_read_byte_data(struct i2c_client *client, int page, int reg)
309 struct pmbus_data *data = i2c_get_clientdata(client);
310 const struct pmbus_driver_info *info = data->info;
313 if (info->read_byte_data) {
314 status = info->read_byte_data(client, page, reg);
315 if (status != -ENODATA)
318 return pmbus_read_byte_data(client, page, reg);
321 int pmbus_update_fan(struct i2c_client *client, int page, int id,
322 u8 config, u8 mask, u16 command)
328 from = _pmbus_read_byte_data(client, page,
329 pmbus_fan_config_registers[id]);
333 to = (from & ~mask) | (config & mask);
335 rv = _pmbus_write_byte_data(client, page,
336 pmbus_fan_config_registers[id], to);
341 return _pmbus_write_word_data(client, page,
342 pmbus_fan_command_registers[id], command);
344 EXPORT_SYMBOL_NS_GPL(pmbus_update_fan, PMBUS);
346 int pmbus_read_word_data(struct i2c_client *client, int page, int phase, u8 reg)
350 rv = pmbus_set_page(client, page, phase);
354 return i2c_smbus_read_word_data(client, reg);
356 EXPORT_SYMBOL_NS_GPL(pmbus_read_word_data, PMBUS);
358 static int pmbus_read_virt_reg(struct i2c_client *client, int page, int reg)
364 case PMBUS_VIRT_FAN_TARGET_1 ... PMBUS_VIRT_FAN_TARGET_4:
365 id = reg - PMBUS_VIRT_FAN_TARGET_1;
366 rv = pmbus_get_fan_rate_device(client, page, id, rpm);
377 * _pmbus_read_word_data() is similar to pmbus_read_word_data(), but checks if
378 * a device specific mapping function exists and calls it if necessary.
380 static int _pmbus_read_word_data(struct i2c_client *client, int page,
383 struct pmbus_data *data = i2c_get_clientdata(client);
384 const struct pmbus_driver_info *info = data->info;
387 if (info->read_word_data) {
388 status = info->read_word_data(client, page, phase, reg);
389 if (status != -ENODATA)
393 if (reg >= PMBUS_VIRT_BASE)
394 return pmbus_read_virt_reg(client, page, reg);
396 return pmbus_read_word_data(client, page, phase, reg);
399 /* Same as above, but without phase parameter, for use in check functions */
400 static int __pmbus_read_word_data(struct i2c_client *client, int page, int reg)
402 return _pmbus_read_word_data(client, page, 0xff, reg);
405 int pmbus_read_byte_data(struct i2c_client *client, int page, u8 reg)
409 rv = pmbus_set_page(client, page, 0xff);
413 return i2c_smbus_read_byte_data(client, reg);
415 EXPORT_SYMBOL_NS_GPL(pmbus_read_byte_data, PMBUS);
417 int pmbus_write_byte_data(struct i2c_client *client, int page, u8 reg, u8 value)
421 rv = pmbus_set_page(client, page, 0xff);
425 return i2c_smbus_write_byte_data(client, reg, value);
427 EXPORT_SYMBOL_NS_GPL(pmbus_write_byte_data, PMBUS);
429 int pmbus_update_byte_data(struct i2c_client *client, int page, u8 reg,
435 rv = _pmbus_read_byte_data(client, page, reg);
439 tmp = (rv & ~mask) | (value & mask);
442 rv = _pmbus_write_byte_data(client, page, reg, tmp);
446 EXPORT_SYMBOL_NS_GPL(pmbus_update_byte_data, PMBUS);
448 static int pmbus_read_block_data(struct i2c_client *client, int page, u8 reg,
453 rv = pmbus_set_page(client, page, 0xff);
457 return i2c_smbus_read_block_data(client, reg, data_buf);
460 static struct pmbus_sensor *pmbus_find_sensor(struct pmbus_data *data, int page,
463 struct pmbus_sensor *sensor;
465 for (sensor = data->sensors; sensor; sensor = sensor->next) {
466 if (sensor->page == page && sensor->reg == reg)
470 return ERR_PTR(-EINVAL);
473 static int pmbus_get_fan_rate(struct i2c_client *client, int page, int id,
474 enum pmbus_fan_mode mode,
477 struct pmbus_data *data = i2c_get_clientdata(client);
478 bool want_rpm, have_rpm;
479 struct pmbus_sensor *s;
483 want_rpm = (mode == rpm);
486 reg = want_rpm ? PMBUS_VIRT_FAN_TARGET_1 : PMBUS_VIRT_PWM_1;
487 s = pmbus_find_sensor(data, page, reg + id);
494 config = _pmbus_read_byte_data(client, page,
495 pmbus_fan_config_registers[id]);
499 have_rpm = !!(config & pmbus_fan_rpm_mask[id]);
500 if (want_rpm == have_rpm)
501 return pmbus_read_word_data(client, page, 0xff,
502 pmbus_fan_command_registers[id]);
504 /* Can't sensibly map between RPM and PWM, just return zero */
508 int pmbus_get_fan_rate_device(struct i2c_client *client, int page, int id,
509 enum pmbus_fan_mode mode)
511 return pmbus_get_fan_rate(client, page, id, mode, false);
513 EXPORT_SYMBOL_NS_GPL(pmbus_get_fan_rate_device, PMBUS);
515 int pmbus_get_fan_rate_cached(struct i2c_client *client, int page, int id,
516 enum pmbus_fan_mode mode)
518 return pmbus_get_fan_rate(client, page, id, mode, true);
520 EXPORT_SYMBOL_NS_GPL(pmbus_get_fan_rate_cached, PMBUS);
522 static void pmbus_clear_fault_page(struct i2c_client *client, int page)
524 _pmbus_write_byte(client, page, PMBUS_CLEAR_FAULTS);
527 void pmbus_clear_faults(struct i2c_client *client)
529 struct pmbus_data *data = i2c_get_clientdata(client);
532 for (i = 0; i < data->info->pages; i++)
533 pmbus_clear_fault_page(client, i);
535 EXPORT_SYMBOL_NS_GPL(pmbus_clear_faults, PMBUS);
537 static int pmbus_check_status_cml(struct i2c_client *client)
539 struct pmbus_data *data = i2c_get_clientdata(client);
542 status = data->read_status(client, -1);
543 if (status < 0 || (status & PB_STATUS_CML)) {
544 status2 = _pmbus_read_byte_data(client, -1, PMBUS_STATUS_CML);
545 if (status2 < 0 || (status2 & PB_CML_FAULT_INVALID_COMMAND))
551 static bool pmbus_check_register(struct i2c_client *client,
552 int (*func)(struct i2c_client *client,
557 struct pmbus_data *data = i2c_get_clientdata(client);
559 rv = func(client, page, reg);
560 if (rv >= 0 && !(data->flags & PMBUS_SKIP_STATUS_CHECK))
561 rv = pmbus_check_status_cml(client);
562 if (rv < 0 && (data->flags & PMBUS_READ_STATUS_AFTER_FAILED_CHECK))
563 data->read_status(client, -1);
564 pmbus_clear_fault_page(client, -1);
568 static bool pmbus_check_status_register(struct i2c_client *client, int page)
571 struct pmbus_data *data = i2c_get_clientdata(client);
573 status = data->read_status(client, page);
574 if (status >= 0 && !(data->flags & PMBUS_SKIP_STATUS_CHECK) &&
575 (status & PB_STATUS_CML)) {
576 status = _pmbus_read_byte_data(client, -1, PMBUS_STATUS_CML);
577 if (status < 0 || (status & PB_CML_FAULT_INVALID_COMMAND))
581 pmbus_clear_fault_page(client, -1);
585 bool pmbus_check_byte_register(struct i2c_client *client, int page, int reg)
587 return pmbus_check_register(client, _pmbus_read_byte_data, page, reg);
589 EXPORT_SYMBOL_NS_GPL(pmbus_check_byte_register, PMBUS);
591 bool pmbus_check_word_register(struct i2c_client *client, int page, int reg)
593 return pmbus_check_register(client, __pmbus_read_word_data, page, reg);
595 EXPORT_SYMBOL_NS_GPL(pmbus_check_word_register, PMBUS);
597 static bool __maybe_unused pmbus_check_block_register(struct i2c_client *client,
601 struct pmbus_data *data = i2c_get_clientdata(client);
602 char data_buf[I2C_SMBUS_BLOCK_MAX + 2];
604 rv = pmbus_read_block_data(client, page, reg, data_buf);
605 if (rv >= 0 && !(data->flags & PMBUS_SKIP_STATUS_CHECK))
606 rv = pmbus_check_status_cml(client);
607 if (rv < 0 && (data->flags & PMBUS_READ_STATUS_AFTER_FAILED_CHECK))
608 data->read_status(client, -1);
609 pmbus_clear_fault_page(client, -1);
613 const struct pmbus_driver_info *pmbus_get_driver_info(struct i2c_client *client)
615 struct pmbus_data *data = i2c_get_clientdata(client);
619 EXPORT_SYMBOL_NS_GPL(pmbus_get_driver_info, PMBUS);
621 static int pmbus_get_status(struct i2c_client *client, int page, int reg)
623 struct pmbus_data *data = i2c_get_clientdata(client);
627 case PMBUS_STATUS_WORD:
628 status = data->read_status(client, page);
631 status = _pmbus_read_byte_data(client, page, reg);
635 pmbus_clear_faults(client);
639 static void pmbus_update_sensor_data(struct i2c_client *client, struct pmbus_sensor *sensor)
641 if (sensor->data < 0 || sensor->update)
642 sensor->data = _pmbus_read_word_data(client, sensor->page,
643 sensor->phase, sensor->reg);
647 * Convert ieee754 sensor values to milli- or micro-units
648 * depending on sensor type.
650 * ieee754 data format:
652 * bit 10..14: exponent
655 * v=(−1)^signbit * 2^(−14) * 0.significantbits
657 * v=(−1)^signbit * 2^(exponent - 15) * 1.significantbits
661 * Add the number mantissa bits into the calculations for simplicity.
662 * To do that, add '10' to the exponent. By doing that, we can just add
663 * 0x400 to normal values and get the expected result.
665 static long pmbus_reg2data_ieee754(struct pmbus_data *data,
666 struct pmbus_sensor *sensor)
672 /* only support half precision for now */
673 sign = sensor->data & 0x8000;
674 exponent = (sensor->data >> 10) & 0x1f;
675 val = sensor->data & 0x3ff;
677 if (exponent == 0) { /* subnormal */
678 exponent = -(14 + 10);
679 } else if (exponent == 0x1f) { /* NaN, convert to min/max */
683 exponent -= (15 + 10); /* normal */
687 /* scale result to milli-units for all sensors except fans */
688 if (sensor->class != PSC_FAN)
691 /* scale result to micro-units for power sensors */
692 if (sensor->class == PSC_POWER)
707 * Convert linear sensor values to milli- or micro-units
708 * depending on sensor type.
710 static s64 pmbus_reg2data_linear(struct pmbus_data *data,
711 struct pmbus_sensor *sensor)
717 if (sensor->class == PSC_VOLTAGE_OUT) { /* LINEAR16 */
718 exponent = data->exponent[sensor->page];
719 mantissa = (u16) sensor->data;
720 } else { /* LINEAR11 */
721 exponent = ((s16)sensor->data) >> 11;
722 mantissa = ((s16)((sensor->data & 0x7ff) << 5)) >> 5;
727 /* scale result to milli-units for all sensors except fans */
728 if (sensor->class != PSC_FAN)
731 /* scale result to micro-units for power sensors */
732 if (sensor->class == PSC_POWER)
744 * Convert direct sensor values to milli- or micro-units
745 * depending on sensor type.
747 static s64 pmbus_reg2data_direct(struct pmbus_data *data,
748 struct pmbus_sensor *sensor)
750 s64 b, val = (s16)sensor->data;
753 m = data->info->m[sensor->class];
754 b = data->info->b[sensor->class];
755 R = data->info->R[sensor->class];
760 /* X = 1/m * (Y * 10^-R - b) */
762 /* scale result to milli-units for everything but fans */
763 if (!(sensor->class == PSC_FAN || sensor->class == PSC_PWM)) {
768 /* scale result to micro-units for power sensors */
769 if (sensor->class == PSC_POWER) {
779 val = div_s64(val + 5LL, 10L); /* round closest */
783 val = div_s64(val - b, m);
788 * Convert VID sensor values to milli- or micro-units
789 * depending on sensor type.
791 static s64 pmbus_reg2data_vid(struct pmbus_data *data,
792 struct pmbus_sensor *sensor)
794 long val = sensor->data;
797 switch (data->info->vrm_version[sensor->page]) {
799 if (val >= 0x02 && val <= 0xb2)
800 rv = DIV_ROUND_CLOSEST(160000 - (val - 2) * 625, 100);
804 rv = 250 + (val - 1) * 5;
808 rv = 500 + (val - 1) * 10;
812 rv = 200 + (val - 1) * 10;
815 if (val >= 0x0 && val <= 0xd8)
816 rv = DIV_ROUND_CLOSEST(155000 - val * 625, 100);
822 static s64 pmbus_reg2data(struct pmbus_data *data, struct pmbus_sensor *sensor)
826 if (!sensor->convert)
829 switch (data->info->format[sensor->class]) {
831 val = pmbus_reg2data_direct(data, sensor);
834 val = pmbus_reg2data_vid(data, sensor);
837 val = pmbus_reg2data_ieee754(data, sensor);
841 val = pmbus_reg2data_linear(data, sensor);
847 #define MAX_IEEE_MANTISSA (0x7ff * 1000)
848 #define MIN_IEEE_MANTISSA (0x400 * 1000)
850 static u16 pmbus_data2reg_ieee754(struct pmbus_data *data,
851 struct pmbus_sensor *sensor, long val)
853 u16 exponent = (15 + 10);
866 /* Power is in uW. Convert to mW before converting. */
867 if (sensor->class == PSC_POWER)
868 val = DIV_ROUND_CLOSEST(val, 1000L);
871 * For simplicity, convert fan data to milli-units
872 * before calculating the exponent.
874 if (sensor->class == PSC_FAN)
877 /* Reduce large mantissa until it fits into 10 bit */
878 while (val > MAX_IEEE_MANTISSA && exponent < 30) {
883 * Increase small mantissa to generate valid 'normal'
886 while (val < MIN_IEEE_MANTISSA && exponent > 1) {
891 /* Convert mantissa from milli-units to units */
892 mantissa = DIV_ROUND_CLOSEST(val, 1000);
895 * Ensure that the resulting number is within range.
896 * Valid range is 0x400..0x7ff, where bit 10 reflects
897 * the implied high bit in normalized ieee754 numbers.
898 * Set the range to 0x400..0x7ff to reflect this.
899 * The upper bit is then removed by the mask against
900 * 0x3ff in the final assignment.
902 if (mantissa > 0x7ff)
904 else if (mantissa < 0x400)
907 /* Convert to sign, 5 bit exponent, 10 bit mantissa */
908 return sign | (mantissa & 0x3ff) | ((exponent << 10) & 0x7c00);
911 #define MAX_LIN_MANTISSA (1023 * 1000)
912 #define MIN_LIN_MANTISSA (511 * 1000)
914 static u16 pmbus_data2reg_linear(struct pmbus_data *data,
915 struct pmbus_sensor *sensor, s64 val)
917 s16 exponent = 0, mantissa;
918 bool negative = false;
924 if (sensor->class == PSC_VOLTAGE_OUT) {
925 /* LINEAR16 does not support negative voltages */
930 * For a static exponents, we don't have a choice
931 * but to adjust the value to it.
933 if (data->exponent[sensor->page] < 0)
934 val <<= -data->exponent[sensor->page];
936 val >>= data->exponent[sensor->page];
937 val = DIV_ROUND_CLOSEST_ULL(val, 1000);
938 return clamp_val(val, 0, 0xffff);
946 /* Power is in uW. Convert to mW before converting. */
947 if (sensor->class == PSC_POWER)
948 val = DIV_ROUND_CLOSEST_ULL(val, 1000);
951 * For simplicity, convert fan data to milli-units
952 * before calculating the exponent.
954 if (sensor->class == PSC_FAN)
957 /* Reduce large mantissa until it fits into 10 bit */
958 while (val >= MAX_LIN_MANTISSA && exponent < 15) {
962 /* Increase small mantissa to improve precision */
963 while (val < MIN_LIN_MANTISSA && exponent > -15) {
968 /* Convert mantissa from milli-units to units */
969 mantissa = clamp_val(DIV_ROUND_CLOSEST_ULL(val, 1000), 0, 0x3ff);
973 mantissa = -mantissa;
975 /* Convert to 5 bit exponent, 11 bit mantissa */
976 return (mantissa & 0x7ff) | ((exponent << 11) & 0xf800);
979 static u16 pmbus_data2reg_direct(struct pmbus_data *data,
980 struct pmbus_sensor *sensor, s64 val)
985 m = data->info->m[sensor->class];
986 b = data->info->b[sensor->class];
987 R = data->info->R[sensor->class];
989 /* Power is in uW. Adjust R and b. */
990 if (sensor->class == PSC_POWER) {
995 /* Calculate Y = (m * X + b) * 10^R */
996 if (!(sensor->class == PSC_FAN || sensor->class == PSC_PWM)) {
997 R -= 3; /* Adjust R and b for data in milli-units */
1007 val = div_s64(val + 5LL, 10L); /* round closest */
1011 return (u16)clamp_val(val, S16_MIN, S16_MAX);
1014 static u16 pmbus_data2reg_vid(struct pmbus_data *data,
1015 struct pmbus_sensor *sensor, s64 val)
1017 val = clamp_val(val, 500, 1600);
1019 return 2 + DIV_ROUND_CLOSEST_ULL((1600LL - val) * 100LL, 625);
1022 static u16 pmbus_data2reg(struct pmbus_data *data,
1023 struct pmbus_sensor *sensor, s64 val)
1027 if (!sensor->convert)
1030 switch (data->info->format[sensor->class]) {
1032 regval = pmbus_data2reg_direct(data, sensor, val);
1035 regval = pmbus_data2reg_vid(data, sensor, val);
1038 regval = pmbus_data2reg_ieee754(data, sensor, val);
1042 regval = pmbus_data2reg_linear(data, sensor, val);
1049 * Return boolean calculated from converted data.
1050 * <index> defines a status register index and mask.
1051 * The mask is in the lower 8 bits, the register index is in bits 8..23.
1053 * The associated pmbus_boolean structure contains optional pointers to two
1054 * sensor attributes. If specified, those attributes are compared against each
1055 * other to determine if a limit has been exceeded.
1057 * If the sensor attribute pointers are NULL, the function returns true if
1058 * (status[reg] & mask) is true.
1060 * If sensor attribute pointers are provided, a comparison against a specified
1061 * limit has to be performed to determine the boolean result.
1062 * In this case, the function returns true if v1 >= v2 (where v1 and v2 are
1063 * sensor values referenced by sensor attribute pointers s1 and s2).
1065 * To determine if an object exceeds upper limits, specify <s1,s2> = <v,limit>.
1066 * To determine if an object exceeds lower limits, specify <s1,s2> = <limit,v>.
1068 * If a negative value is stored in any of the referenced registers, this value
1069 * reflects an error code which will be returned.
1071 static int pmbus_get_boolean(struct i2c_client *client, struct pmbus_boolean *b,
1074 struct pmbus_data *data = i2c_get_clientdata(client);
1075 struct pmbus_sensor *s1 = b->s1;
1076 struct pmbus_sensor *s2 = b->s2;
1077 u16 mask = pb_index_to_mask(index);
1078 u8 page = pb_index_to_page(index);
1079 u16 reg = pb_index_to_reg(index);
1083 mutex_lock(&data->update_lock);
1084 status = pmbus_get_status(client, page, reg);
1091 pmbus_update_sensor_data(client, s1);
1093 pmbus_update_sensor_data(client, s2);
1095 regval = status & mask;
1097 ret = _pmbus_write_byte_data(client, page, reg, regval);
1113 v1 = pmbus_reg2data(data, s1);
1114 v2 = pmbus_reg2data(data, s2);
1115 ret = !!(regval && v1 >= v2);
1120 mutex_unlock(&data->update_lock);
1124 static ssize_t pmbus_show_boolean(struct device *dev,
1125 struct device_attribute *da, char *buf)
1127 struct sensor_device_attribute *attr = to_sensor_dev_attr(da);
1128 struct pmbus_boolean *boolean = to_pmbus_boolean(attr);
1129 struct i2c_client *client = to_i2c_client(dev->parent);
1132 val = pmbus_get_boolean(client, boolean, attr->index);
1135 return sysfs_emit(buf, "%d\n", val);
1138 static ssize_t pmbus_show_sensor(struct device *dev,
1139 struct device_attribute *devattr, char *buf)
1141 struct i2c_client *client = to_i2c_client(dev->parent);
1142 struct pmbus_sensor *sensor = to_pmbus_sensor(devattr);
1143 struct pmbus_data *data = i2c_get_clientdata(client);
1146 mutex_lock(&data->update_lock);
1147 pmbus_update_sensor_data(client, sensor);
1148 if (sensor->data < 0)
1151 ret = sysfs_emit(buf, "%lld\n", pmbus_reg2data(data, sensor));
1152 mutex_unlock(&data->update_lock);
1156 static ssize_t pmbus_set_sensor(struct device *dev,
1157 struct device_attribute *devattr,
1158 const char *buf, size_t count)
1160 struct i2c_client *client = to_i2c_client(dev->parent);
1161 struct pmbus_data *data = i2c_get_clientdata(client);
1162 struct pmbus_sensor *sensor = to_pmbus_sensor(devattr);
1168 if (kstrtos64(buf, 10, &val) < 0)
1171 mutex_lock(&data->update_lock);
1172 regval = pmbus_data2reg(data, sensor, val);
1173 ret = _pmbus_write_word_data(client, sensor->page, sensor->reg, regval);
1177 sensor->data = -ENODATA;
1178 mutex_unlock(&data->update_lock);
1182 static ssize_t pmbus_show_label(struct device *dev,
1183 struct device_attribute *da, char *buf)
1185 struct pmbus_label *label = to_pmbus_label(da);
1187 return sysfs_emit(buf, "%s\n", label->label);
1190 static int pmbus_add_attribute(struct pmbus_data *data, struct attribute *attr)
1192 if (data->num_attributes >= data->max_attributes - 1) {
1193 int new_max_attrs = data->max_attributes + PMBUS_ATTR_ALLOC_SIZE;
1194 void *new_attrs = devm_krealloc(data->dev, data->group.attrs,
1195 new_max_attrs * sizeof(void *),
1199 data->group.attrs = new_attrs;
1200 data->max_attributes = new_max_attrs;
1203 data->group.attrs[data->num_attributes++] = attr;
1204 data->group.attrs[data->num_attributes] = NULL;
1208 static void pmbus_dev_attr_init(struct device_attribute *dev_attr,
1211 ssize_t (*show)(struct device *dev,
1212 struct device_attribute *attr,
1214 ssize_t (*store)(struct device *dev,
1215 struct device_attribute *attr,
1216 const char *buf, size_t count))
1218 sysfs_attr_init(&dev_attr->attr);
1219 dev_attr->attr.name = name;
1220 dev_attr->attr.mode = mode;
1221 dev_attr->show = show;
1222 dev_attr->store = store;
1225 static void pmbus_attr_init(struct sensor_device_attribute *a,
1228 ssize_t (*show)(struct device *dev,
1229 struct device_attribute *attr,
1231 ssize_t (*store)(struct device *dev,
1232 struct device_attribute *attr,
1233 const char *buf, size_t count),
1236 pmbus_dev_attr_init(&a->dev_attr, name, mode, show, store);
1240 static int pmbus_add_boolean(struct pmbus_data *data,
1241 const char *name, const char *type, int seq,
1242 struct pmbus_sensor *s1,
1243 struct pmbus_sensor *s2,
1244 u8 page, u16 reg, u16 mask)
1246 struct pmbus_boolean *boolean;
1247 struct sensor_device_attribute *a;
1249 if (WARN((s1 && !s2) || (!s1 && s2), "Bad s1/s2 parameters\n"))
1252 boolean = devm_kzalloc(data->dev, sizeof(*boolean), GFP_KERNEL);
1256 a = &boolean->attribute;
1258 snprintf(boolean->name, sizeof(boolean->name), "%s%d_%s",
1262 pmbus_attr_init(a, boolean->name, 0444, pmbus_show_boolean, NULL,
1263 pb_reg_to_index(page, reg, mask));
1265 return pmbus_add_attribute(data, &a->dev_attr.attr);
1268 /* of thermal for pmbus temperature sensors */
1269 struct pmbus_thermal_data {
1270 struct pmbus_data *pmbus_data;
1271 struct pmbus_sensor *sensor;
1274 static int pmbus_thermal_get_temp(struct thermal_zone_device *tz, int *temp)
1276 struct pmbus_thermal_data *tdata = thermal_zone_device_priv(tz);
1277 struct pmbus_sensor *sensor = tdata->sensor;
1278 struct pmbus_data *pmbus_data = tdata->pmbus_data;
1279 struct i2c_client *client = to_i2c_client(pmbus_data->dev);
1280 struct device *dev = pmbus_data->hwmon_dev;
1284 /* May not even get to hwmon yet */
1289 mutex_lock(&pmbus_data->update_lock);
1290 pmbus_update_sensor_data(client, sensor);
1291 if (sensor->data < 0)
1294 *temp = (int)pmbus_reg2data(pmbus_data, sensor);
1295 mutex_unlock(&pmbus_data->update_lock);
1300 static const struct thermal_zone_device_ops pmbus_thermal_ops = {
1301 .get_temp = pmbus_thermal_get_temp,
1304 static int pmbus_thermal_add_sensor(struct pmbus_data *pmbus_data,
1305 struct pmbus_sensor *sensor, int index)
1307 struct device *dev = pmbus_data->dev;
1308 struct pmbus_thermal_data *tdata;
1309 struct thermal_zone_device *tzd;
1311 tdata = devm_kzalloc(dev, sizeof(*tdata), GFP_KERNEL);
1315 tdata->sensor = sensor;
1316 tdata->pmbus_data = pmbus_data;
1318 tzd = devm_thermal_of_zone_register(dev, index, tdata,
1319 &pmbus_thermal_ops);
1321 * If CONFIG_THERMAL_OF is disabled, this returns -ENODEV,
1322 * so ignore that error but forward any other error.
1324 if (IS_ERR(tzd) && (PTR_ERR(tzd) != -ENODEV))
1325 return PTR_ERR(tzd);
1330 static struct pmbus_sensor *pmbus_add_sensor(struct pmbus_data *data,
1331 const char *name, const char *type,
1332 int seq, int page, int phase,
1334 enum pmbus_sensor_classes class,
1335 bool update, bool readonly,
1338 struct pmbus_sensor *sensor;
1339 struct device_attribute *a;
1341 sensor = devm_kzalloc(data->dev, sizeof(*sensor), GFP_KERNEL);
1344 a = &sensor->attribute;
1347 snprintf(sensor->name, sizeof(sensor->name), "%s%d_%s",
1350 snprintf(sensor->name, sizeof(sensor->name), "%s%d",
1353 if (data->flags & PMBUS_WRITE_PROTECTED)
1356 sensor->page = page;
1357 sensor->phase = phase;
1359 sensor->class = class;
1360 sensor->update = update;
1361 sensor->convert = convert;
1362 sensor->data = -ENODATA;
1363 pmbus_dev_attr_init(a, sensor->name,
1364 readonly ? 0444 : 0644,
1365 pmbus_show_sensor, pmbus_set_sensor);
1367 if (pmbus_add_attribute(data, &a->attr))
1370 sensor->next = data->sensors;
1371 data->sensors = sensor;
1373 /* temperature sensors with _input values are registered with thermal */
1374 if (class == PSC_TEMPERATURE && strcmp(type, "input") == 0)
1375 pmbus_thermal_add_sensor(data, sensor, seq);
1380 static int pmbus_add_label(struct pmbus_data *data,
1381 const char *name, int seq,
1382 const char *lstring, int index, int phase)
1384 struct pmbus_label *label;
1385 struct device_attribute *a;
1387 label = devm_kzalloc(data->dev, sizeof(*label), GFP_KERNEL);
1391 a = &label->attribute;
1393 snprintf(label->name, sizeof(label->name), "%s%d_label", name, seq);
1396 strncpy(label->label, lstring,
1397 sizeof(label->label) - 1);
1399 snprintf(label->label, sizeof(label->label), "%s.%d",
1403 snprintf(label->label, sizeof(label->label), "%s%d",
1406 snprintf(label->label, sizeof(label->label), "%s%d.%d",
1407 lstring, index, phase);
1410 pmbus_dev_attr_init(a, label->name, 0444, pmbus_show_label, NULL);
1411 return pmbus_add_attribute(data, &a->attr);
1415 * Search for attributes. Allocate sensors, booleans, and labels as needed.
1419 * The pmbus_limit_attr structure describes a single limit attribute
1420 * and its associated alarm attribute.
1422 struct pmbus_limit_attr {
1423 u16 reg; /* Limit register */
1424 u16 sbit; /* Alarm attribute status bit */
1425 bool update; /* True if register needs updates */
1426 bool low; /* True if low limit; for limits with compare
1428 const char *attr; /* Attribute name */
1429 const char *alarm; /* Alarm attribute name */
1433 * The pmbus_sensor_attr structure describes one sensor attribute. This
1434 * description includes a reference to the associated limit attributes.
1436 struct pmbus_sensor_attr {
1437 u16 reg; /* sensor register */
1438 u16 gbit; /* generic status bit */
1439 u8 nlimit; /* # of limit registers */
1440 enum pmbus_sensor_classes class;/* sensor class */
1441 const char *label; /* sensor label */
1442 bool paged; /* true if paged sensor */
1443 bool update; /* true if update needed */
1444 bool compare; /* true if compare function needed */
1445 u32 func; /* sensor mask */
1446 u32 sfunc; /* sensor status mask */
1447 int sreg; /* status register */
1448 const struct pmbus_limit_attr *limit;/* limit registers */
1452 * Add a set of limit attributes and, if supported, the associated
1454 * returns 0 if no alarm register found, 1 if an alarm register was found,
1457 static int pmbus_add_limit_attrs(struct i2c_client *client,
1458 struct pmbus_data *data,
1459 const struct pmbus_driver_info *info,
1460 const char *name, int index, int page,
1461 struct pmbus_sensor *base,
1462 const struct pmbus_sensor_attr *attr)
1464 const struct pmbus_limit_attr *l = attr->limit;
1465 int nlimit = attr->nlimit;
1468 struct pmbus_sensor *curr;
1470 for (i = 0; i < nlimit; i++) {
1471 if (pmbus_check_word_register(client, page, l->reg)) {
1472 curr = pmbus_add_sensor(data, name, l->attr, index,
1473 page, 0xff, l->reg, attr->class,
1474 attr->update || l->update,
1478 if (l->sbit && (info->func[page] & attr->sfunc)) {
1479 ret = pmbus_add_boolean(data, name,
1481 attr->compare ? l->low ? curr : base
1483 attr->compare ? l->low ? base : curr
1485 page, attr->sreg, l->sbit);
1496 static int pmbus_add_sensor_attrs_one(struct i2c_client *client,
1497 struct pmbus_data *data,
1498 const struct pmbus_driver_info *info,
1500 int index, int page, int phase,
1501 const struct pmbus_sensor_attr *attr,
1504 struct pmbus_sensor *base;
1505 bool upper = !!(attr->gbit & 0xff00); /* need to check STATUS_WORD */
1509 ret = pmbus_add_label(data, name, index, attr->label,
1510 paged ? page + 1 : 0, phase);
1514 base = pmbus_add_sensor(data, name, "input", index, page, phase,
1515 attr->reg, attr->class, true, true, true);
1518 /* No limit and alarm attributes for phase specific sensors */
1519 if (attr->sfunc && phase == 0xff) {
1520 ret = pmbus_add_limit_attrs(client, data, info, name,
1521 index, page, base, attr);
1525 * Add generic alarm attribute only if there are no individual
1526 * alarm attributes, if there is a global alarm bit, and if
1527 * the generic status register (word or byte, depending on
1528 * which global bit is set) for this page is accessible.
1530 if (!ret && attr->gbit &&
1531 (!upper || data->has_status_word) &&
1532 pmbus_check_status_register(client, page)) {
1533 ret = pmbus_add_boolean(data, name, "alarm", index,
1535 page, PMBUS_STATUS_WORD,
1544 static bool pmbus_sensor_is_paged(const struct pmbus_driver_info *info,
1545 const struct pmbus_sensor_attr *attr)
1553 * Some attributes may be present on more than one page despite
1554 * not being marked with the paged attribute. If that is the case,
1555 * then treat the sensor as being paged and add the page suffix to the
1557 * We don't just add the paged attribute to all such attributes, in
1558 * order to maintain the un-suffixed labels in the case where the
1559 * attribute is only on page 0.
1561 for (p = 1; p < info->pages; p++) {
1562 if (info->func[p] & attr->func)
1568 static int pmbus_add_sensor_attrs(struct i2c_client *client,
1569 struct pmbus_data *data,
1571 const struct pmbus_sensor_attr *attrs,
1574 const struct pmbus_driver_info *info = data->info;
1579 for (i = 0; i < nattrs; i++) {
1581 bool paged = pmbus_sensor_is_paged(info, attrs);
1583 pages = paged ? info->pages : 1;
1584 for (page = 0; page < pages; page++) {
1585 if (info->func[page] & attrs->func) {
1586 ret = pmbus_add_sensor_attrs_one(client, data, info,
1588 0xff, attrs, paged);
1593 if (info->phases[page]) {
1596 for (phase = 0; phase < info->phases[page];
1598 if (!(info->pfunc[phase] & attrs->func))
1600 ret = pmbus_add_sensor_attrs_one(client,
1601 data, info, name, index, page,
1602 phase, attrs, paged);
1614 static const struct pmbus_limit_attr vin_limit_attrs[] = {
1616 .reg = PMBUS_VIN_UV_WARN_LIMIT,
1618 .alarm = "min_alarm",
1619 .sbit = PB_VOLTAGE_UV_WARNING,
1621 .reg = PMBUS_VIN_UV_FAULT_LIMIT,
1623 .alarm = "lcrit_alarm",
1624 .sbit = PB_VOLTAGE_UV_FAULT | PB_VOLTAGE_VIN_OFF,
1626 .reg = PMBUS_VIN_OV_WARN_LIMIT,
1628 .alarm = "max_alarm",
1629 .sbit = PB_VOLTAGE_OV_WARNING,
1631 .reg = PMBUS_VIN_OV_FAULT_LIMIT,
1633 .alarm = "crit_alarm",
1634 .sbit = PB_VOLTAGE_OV_FAULT,
1636 .reg = PMBUS_VIRT_READ_VIN_AVG,
1640 .reg = PMBUS_VIRT_READ_VIN_MIN,
1644 .reg = PMBUS_VIRT_READ_VIN_MAX,
1648 .reg = PMBUS_VIRT_RESET_VIN_HISTORY,
1649 .attr = "reset_history",
1651 .reg = PMBUS_MFR_VIN_MIN,
1652 .attr = "rated_min",
1654 .reg = PMBUS_MFR_VIN_MAX,
1655 .attr = "rated_max",
1659 static const struct pmbus_limit_attr vmon_limit_attrs[] = {
1661 .reg = PMBUS_VIRT_VMON_UV_WARN_LIMIT,
1663 .alarm = "min_alarm",
1664 .sbit = PB_VOLTAGE_UV_WARNING,
1666 .reg = PMBUS_VIRT_VMON_UV_FAULT_LIMIT,
1668 .alarm = "lcrit_alarm",
1669 .sbit = PB_VOLTAGE_UV_FAULT,
1671 .reg = PMBUS_VIRT_VMON_OV_WARN_LIMIT,
1673 .alarm = "max_alarm",
1674 .sbit = PB_VOLTAGE_OV_WARNING,
1676 .reg = PMBUS_VIRT_VMON_OV_FAULT_LIMIT,
1678 .alarm = "crit_alarm",
1679 .sbit = PB_VOLTAGE_OV_FAULT,
1683 static const struct pmbus_limit_attr vout_limit_attrs[] = {
1685 .reg = PMBUS_VOUT_UV_WARN_LIMIT,
1687 .alarm = "min_alarm",
1688 .sbit = PB_VOLTAGE_UV_WARNING,
1690 .reg = PMBUS_VOUT_UV_FAULT_LIMIT,
1692 .alarm = "lcrit_alarm",
1693 .sbit = PB_VOLTAGE_UV_FAULT,
1695 .reg = PMBUS_VOUT_OV_WARN_LIMIT,
1697 .alarm = "max_alarm",
1698 .sbit = PB_VOLTAGE_OV_WARNING,
1700 .reg = PMBUS_VOUT_OV_FAULT_LIMIT,
1702 .alarm = "crit_alarm",
1703 .sbit = PB_VOLTAGE_OV_FAULT,
1705 .reg = PMBUS_VIRT_READ_VOUT_AVG,
1709 .reg = PMBUS_VIRT_READ_VOUT_MIN,
1713 .reg = PMBUS_VIRT_READ_VOUT_MAX,
1717 .reg = PMBUS_VIRT_RESET_VOUT_HISTORY,
1718 .attr = "reset_history",
1720 .reg = PMBUS_MFR_VOUT_MIN,
1721 .attr = "rated_min",
1723 .reg = PMBUS_MFR_VOUT_MAX,
1724 .attr = "rated_max",
1728 static const struct pmbus_sensor_attr voltage_attributes[] = {
1730 .reg = PMBUS_READ_VIN,
1731 .class = PSC_VOLTAGE_IN,
1733 .func = PMBUS_HAVE_VIN,
1734 .sfunc = PMBUS_HAVE_STATUS_INPUT,
1735 .sreg = PMBUS_STATUS_INPUT,
1736 .gbit = PB_STATUS_VIN_UV,
1737 .limit = vin_limit_attrs,
1738 .nlimit = ARRAY_SIZE(vin_limit_attrs),
1740 .reg = PMBUS_VIRT_READ_VMON,
1741 .class = PSC_VOLTAGE_IN,
1743 .func = PMBUS_HAVE_VMON,
1744 .sfunc = PMBUS_HAVE_STATUS_VMON,
1745 .sreg = PMBUS_VIRT_STATUS_VMON,
1746 .limit = vmon_limit_attrs,
1747 .nlimit = ARRAY_SIZE(vmon_limit_attrs),
1749 .reg = PMBUS_READ_VCAP,
1750 .class = PSC_VOLTAGE_IN,
1752 .func = PMBUS_HAVE_VCAP,
1754 .reg = PMBUS_READ_VOUT,
1755 .class = PSC_VOLTAGE_OUT,
1758 .func = PMBUS_HAVE_VOUT,
1759 .sfunc = PMBUS_HAVE_STATUS_VOUT,
1760 .sreg = PMBUS_STATUS_VOUT,
1761 .gbit = PB_STATUS_VOUT_OV,
1762 .limit = vout_limit_attrs,
1763 .nlimit = ARRAY_SIZE(vout_limit_attrs),
1767 /* Current attributes */
1769 static const struct pmbus_limit_attr iin_limit_attrs[] = {
1771 .reg = PMBUS_IIN_OC_WARN_LIMIT,
1773 .alarm = "max_alarm",
1774 .sbit = PB_IIN_OC_WARNING,
1776 .reg = PMBUS_IIN_OC_FAULT_LIMIT,
1778 .alarm = "crit_alarm",
1779 .sbit = PB_IIN_OC_FAULT,
1781 .reg = PMBUS_VIRT_READ_IIN_AVG,
1785 .reg = PMBUS_VIRT_READ_IIN_MIN,
1789 .reg = PMBUS_VIRT_READ_IIN_MAX,
1793 .reg = PMBUS_VIRT_RESET_IIN_HISTORY,
1794 .attr = "reset_history",
1796 .reg = PMBUS_MFR_IIN_MAX,
1797 .attr = "rated_max",
1801 static const struct pmbus_limit_attr iout_limit_attrs[] = {
1803 .reg = PMBUS_IOUT_OC_WARN_LIMIT,
1805 .alarm = "max_alarm",
1806 .sbit = PB_IOUT_OC_WARNING,
1808 .reg = PMBUS_IOUT_UC_FAULT_LIMIT,
1810 .alarm = "lcrit_alarm",
1811 .sbit = PB_IOUT_UC_FAULT,
1813 .reg = PMBUS_IOUT_OC_FAULT_LIMIT,
1815 .alarm = "crit_alarm",
1816 .sbit = PB_IOUT_OC_FAULT,
1818 .reg = PMBUS_VIRT_READ_IOUT_AVG,
1822 .reg = PMBUS_VIRT_READ_IOUT_MIN,
1826 .reg = PMBUS_VIRT_READ_IOUT_MAX,
1830 .reg = PMBUS_VIRT_RESET_IOUT_HISTORY,
1831 .attr = "reset_history",
1833 .reg = PMBUS_MFR_IOUT_MAX,
1834 .attr = "rated_max",
1838 static const struct pmbus_sensor_attr current_attributes[] = {
1840 .reg = PMBUS_READ_IIN,
1841 .class = PSC_CURRENT_IN,
1843 .func = PMBUS_HAVE_IIN,
1844 .sfunc = PMBUS_HAVE_STATUS_INPUT,
1845 .sreg = PMBUS_STATUS_INPUT,
1846 .gbit = PB_STATUS_INPUT,
1847 .limit = iin_limit_attrs,
1848 .nlimit = ARRAY_SIZE(iin_limit_attrs),
1850 .reg = PMBUS_READ_IOUT,
1851 .class = PSC_CURRENT_OUT,
1854 .func = PMBUS_HAVE_IOUT,
1855 .sfunc = PMBUS_HAVE_STATUS_IOUT,
1856 .sreg = PMBUS_STATUS_IOUT,
1857 .gbit = PB_STATUS_IOUT_OC,
1858 .limit = iout_limit_attrs,
1859 .nlimit = ARRAY_SIZE(iout_limit_attrs),
1863 /* Power attributes */
1865 static const struct pmbus_limit_attr pin_limit_attrs[] = {
1867 .reg = PMBUS_PIN_OP_WARN_LIMIT,
1870 .sbit = PB_PIN_OP_WARNING,
1872 .reg = PMBUS_VIRT_READ_PIN_AVG,
1876 .reg = PMBUS_VIRT_READ_PIN_MIN,
1878 .attr = "input_lowest",
1880 .reg = PMBUS_VIRT_READ_PIN_MAX,
1882 .attr = "input_highest",
1884 .reg = PMBUS_VIRT_RESET_PIN_HISTORY,
1885 .attr = "reset_history",
1887 .reg = PMBUS_MFR_PIN_MAX,
1888 .attr = "rated_max",
1892 static const struct pmbus_limit_attr pout_limit_attrs[] = {
1894 .reg = PMBUS_POUT_MAX,
1896 .alarm = "cap_alarm",
1897 .sbit = PB_POWER_LIMITING,
1899 .reg = PMBUS_POUT_OP_WARN_LIMIT,
1901 .alarm = "max_alarm",
1902 .sbit = PB_POUT_OP_WARNING,
1904 .reg = PMBUS_POUT_OP_FAULT_LIMIT,
1906 .alarm = "crit_alarm",
1907 .sbit = PB_POUT_OP_FAULT,
1909 .reg = PMBUS_VIRT_READ_POUT_AVG,
1913 .reg = PMBUS_VIRT_READ_POUT_MIN,
1915 .attr = "input_lowest",
1917 .reg = PMBUS_VIRT_READ_POUT_MAX,
1919 .attr = "input_highest",
1921 .reg = PMBUS_VIRT_RESET_POUT_HISTORY,
1922 .attr = "reset_history",
1924 .reg = PMBUS_MFR_POUT_MAX,
1925 .attr = "rated_max",
1929 static const struct pmbus_sensor_attr power_attributes[] = {
1931 .reg = PMBUS_READ_PIN,
1934 .func = PMBUS_HAVE_PIN,
1935 .sfunc = PMBUS_HAVE_STATUS_INPUT,
1936 .sreg = PMBUS_STATUS_INPUT,
1937 .gbit = PB_STATUS_INPUT,
1938 .limit = pin_limit_attrs,
1939 .nlimit = ARRAY_SIZE(pin_limit_attrs),
1941 .reg = PMBUS_READ_POUT,
1945 .func = PMBUS_HAVE_POUT,
1946 .sfunc = PMBUS_HAVE_STATUS_IOUT,
1947 .sreg = PMBUS_STATUS_IOUT,
1948 .limit = pout_limit_attrs,
1949 .nlimit = ARRAY_SIZE(pout_limit_attrs),
1953 /* Temperature atributes */
1955 static const struct pmbus_limit_attr temp_limit_attrs[] = {
1957 .reg = PMBUS_UT_WARN_LIMIT,
1960 .alarm = "min_alarm",
1961 .sbit = PB_TEMP_UT_WARNING,
1963 .reg = PMBUS_UT_FAULT_LIMIT,
1966 .alarm = "lcrit_alarm",
1967 .sbit = PB_TEMP_UT_FAULT,
1969 .reg = PMBUS_OT_WARN_LIMIT,
1971 .alarm = "max_alarm",
1972 .sbit = PB_TEMP_OT_WARNING,
1974 .reg = PMBUS_OT_FAULT_LIMIT,
1976 .alarm = "crit_alarm",
1977 .sbit = PB_TEMP_OT_FAULT,
1979 .reg = PMBUS_VIRT_READ_TEMP_MIN,
1982 .reg = PMBUS_VIRT_READ_TEMP_AVG,
1985 .reg = PMBUS_VIRT_READ_TEMP_MAX,
1988 .reg = PMBUS_VIRT_RESET_TEMP_HISTORY,
1989 .attr = "reset_history",
1991 .reg = PMBUS_MFR_MAX_TEMP_1,
1992 .attr = "rated_max",
1996 static const struct pmbus_limit_attr temp_limit_attrs2[] = {
1998 .reg = PMBUS_UT_WARN_LIMIT,
2001 .alarm = "min_alarm",
2002 .sbit = PB_TEMP_UT_WARNING,
2004 .reg = PMBUS_UT_FAULT_LIMIT,
2007 .alarm = "lcrit_alarm",
2008 .sbit = PB_TEMP_UT_FAULT,
2010 .reg = PMBUS_OT_WARN_LIMIT,
2012 .alarm = "max_alarm",
2013 .sbit = PB_TEMP_OT_WARNING,
2015 .reg = PMBUS_OT_FAULT_LIMIT,
2017 .alarm = "crit_alarm",
2018 .sbit = PB_TEMP_OT_FAULT,
2020 .reg = PMBUS_VIRT_READ_TEMP2_MIN,
2023 .reg = PMBUS_VIRT_READ_TEMP2_AVG,
2026 .reg = PMBUS_VIRT_READ_TEMP2_MAX,
2029 .reg = PMBUS_VIRT_RESET_TEMP2_HISTORY,
2030 .attr = "reset_history",
2032 .reg = PMBUS_MFR_MAX_TEMP_2,
2033 .attr = "rated_max",
2037 static const struct pmbus_limit_attr temp_limit_attrs3[] = {
2039 .reg = PMBUS_UT_WARN_LIMIT,
2042 .alarm = "min_alarm",
2043 .sbit = PB_TEMP_UT_WARNING,
2045 .reg = PMBUS_UT_FAULT_LIMIT,
2048 .alarm = "lcrit_alarm",
2049 .sbit = PB_TEMP_UT_FAULT,
2051 .reg = PMBUS_OT_WARN_LIMIT,
2053 .alarm = "max_alarm",
2054 .sbit = PB_TEMP_OT_WARNING,
2056 .reg = PMBUS_OT_FAULT_LIMIT,
2058 .alarm = "crit_alarm",
2059 .sbit = PB_TEMP_OT_FAULT,
2061 .reg = PMBUS_MFR_MAX_TEMP_3,
2062 .attr = "rated_max",
2066 static const struct pmbus_sensor_attr temp_attributes[] = {
2068 .reg = PMBUS_READ_TEMPERATURE_1,
2069 .class = PSC_TEMPERATURE,
2073 .func = PMBUS_HAVE_TEMP,
2074 .sfunc = PMBUS_HAVE_STATUS_TEMP,
2075 .sreg = PMBUS_STATUS_TEMPERATURE,
2076 .gbit = PB_STATUS_TEMPERATURE,
2077 .limit = temp_limit_attrs,
2078 .nlimit = ARRAY_SIZE(temp_limit_attrs),
2080 .reg = PMBUS_READ_TEMPERATURE_2,
2081 .class = PSC_TEMPERATURE,
2085 .func = PMBUS_HAVE_TEMP2,
2086 .sfunc = PMBUS_HAVE_STATUS_TEMP,
2087 .sreg = PMBUS_STATUS_TEMPERATURE,
2088 .gbit = PB_STATUS_TEMPERATURE,
2089 .limit = temp_limit_attrs2,
2090 .nlimit = ARRAY_SIZE(temp_limit_attrs2),
2092 .reg = PMBUS_READ_TEMPERATURE_3,
2093 .class = PSC_TEMPERATURE,
2097 .func = PMBUS_HAVE_TEMP3,
2098 .sfunc = PMBUS_HAVE_STATUS_TEMP,
2099 .sreg = PMBUS_STATUS_TEMPERATURE,
2100 .gbit = PB_STATUS_TEMPERATURE,
2101 .limit = temp_limit_attrs3,
2102 .nlimit = ARRAY_SIZE(temp_limit_attrs3),
2106 static const int pmbus_fan_registers[] = {
2107 PMBUS_READ_FAN_SPEED_1,
2108 PMBUS_READ_FAN_SPEED_2,
2109 PMBUS_READ_FAN_SPEED_3,
2110 PMBUS_READ_FAN_SPEED_4
2113 static const int pmbus_fan_status_registers[] = {
2114 PMBUS_STATUS_FAN_12,
2115 PMBUS_STATUS_FAN_12,
2116 PMBUS_STATUS_FAN_34,
2120 static const u32 pmbus_fan_flags[] = {
2127 static const u32 pmbus_fan_status_flags[] = {
2128 PMBUS_HAVE_STATUS_FAN12,
2129 PMBUS_HAVE_STATUS_FAN12,
2130 PMBUS_HAVE_STATUS_FAN34,
2131 PMBUS_HAVE_STATUS_FAN34
2136 /* Precondition: FAN_CONFIG_x_y and FAN_COMMAND_x must exist for the fan ID */
2137 static int pmbus_add_fan_ctrl(struct i2c_client *client,
2138 struct pmbus_data *data, int index, int page, int id,
2141 struct pmbus_sensor *sensor;
2143 sensor = pmbus_add_sensor(data, "fan", "target", index, page,
2144 0xff, PMBUS_VIRT_FAN_TARGET_1 + id, PSC_FAN,
2145 false, false, true);
2150 if (!((data->info->func[page] & PMBUS_HAVE_PWM12) ||
2151 (data->info->func[page] & PMBUS_HAVE_PWM34)))
2154 sensor = pmbus_add_sensor(data, "pwm", NULL, index, page,
2155 0xff, PMBUS_VIRT_PWM_1 + id, PSC_PWM,
2156 false, false, true);
2161 sensor = pmbus_add_sensor(data, "pwm", "enable", index, page,
2162 0xff, PMBUS_VIRT_PWM_ENABLE_1 + id, PSC_PWM,
2163 true, false, false);
2171 static int pmbus_add_fan_attributes(struct i2c_client *client,
2172 struct pmbus_data *data)
2174 const struct pmbus_driver_info *info = data->info;
2179 for (page = 0; page < info->pages; page++) {
2182 for (f = 0; f < ARRAY_SIZE(pmbus_fan_registers); f++) {
2185 if (!(info->func[page] & pmbus_fan_flags[f]))
2188 if (!pmbus_check_word_register(client, page,
2189 pmbus_fan_registers[f]))
2193 * Skip fan if not installed.
2194 * Each fan configuration register covers multiple fans,
2195 * so we have to do some magic.
2197 regval = _pmbus_read_byte_data(client, page,
2198 pmbus_fan_config_registers[f]);
2200 (!(regval & (PB_FAN_1_INSTALLED >> ((f & 1) * 4)))))
2203 if (pmbus_add_sensor(data, "fan", "input", index,
2204 page, 0xff, pmbus_fan_registers[f],
2205 PSC_FAN, true, true, true) == NULL)
2209 if (pmbus_check_word_register(client, page,
2210 pmbus_fan_command_registers[f])) {
2211 ret = pmbus_add_fan_ctrl(client, data, index,
2218 * Each fan status register covers multiple fans,
2219 * so we have to do some magic.
2221 if ((info->func[page] & pmbus_fan_status_flags[f]) &&
2222 pmbus_check_byte_register(client,
2223 page, pmbus_fan_status_registers[f])) {
2226 if (f > 1) /* fan 3, 4 */
2227 reg = PMBUS_STATUS_FAN_34;
2229 reg = PMBUS_STATUS_FAN_12;
2230 ret = pmbus_add_boolean(data, "fan",
2231 "alarm", index, NULL, NULL, page, reg,
2232 PB_FAN_FAN1_WARNING >> (f & 1));
2235 ret = pmbus_add_boolean(data, "fan",
2236 "fault", index, NULL, NULL, page, reg,
2237 PB_FAN_FAN1_FAULT >> (f & 1));
2247 struct pmbus_samples_attr {
2252 struct pmbus_samples_reg {
2254 struct pmbus_samples_attr *attr;
2255 struct device_attribute dev_attr;
2258 static struct pmbus_samples_attr pmbus_samples_registers[] = {
2260 .reg = PMBUS_VIRT_SAMPLES,
2263 .reg = PMBUS_VIRT_IN_SAMPLES,
2264 .name = "in_samples",
2266 .reg = PMBUS_VIRT_CURR_SAMPLES,
2267 .name = "curr_samples",
2269 .reg = PMBUS_VIRT_POWER_SAMPLES,
2270 .name = "power_samples",
2272 .reg = PMBUS_VIRT_TEMP_SAMPLES,
2273 .name = "temp_samples",
2277 #define to_samples_reg(x) container_of(x, struct pmbus_samples_reg, dev_attr)
2279 static ssize_t pmbus_show_samples(struct device *dev,
2280 struct device_attribute *devattr, char *buf)
2283 struct i2c_client *client = to_i2c_client(dev->parent);
2284 struct pmbus_samples_reg *reg = to_samples_reg(devattr);
2285 struct pmbus_data *data = i2c_get_clientdata(client);
2287 mutex_lock(&data->update_lock);
2288 val = _pmbus_read_word_data(client, reg->page, 0xff, reg->attr->reg);
2289 mutex_unlock(&data->update_lock);
2293 return sysfs_emit(buf, "%d\n", val);
2296 static ssize_t pmbus_set_samples(struct device *dev,
2297 struct device_attribute *devattr,
2298 const char *buf, size_t count)
2302 struct i2c_client *client = to_i2c_client(dev->parent);
2303 struct pmbus_samples_reg *reg = to_samples_reg(devattr);
2304 struct pmbus_data *data = i2c_get_clientdata(client);
2306 if (kstrtol(buf, 0, &val) < 0)
2309 mutex_lock(&data->update_lock);
2310 ret = _pmbus_write_word_data(client, reg->page, reg->attr->reg, val);
2311 mutex_unlock(&data->update_lock);
2313 return ret ? : count;
2316 static int pmbus_add_samples_attr(struct pmbus_data *data, int page,
2317 struct pmbus_samples_attr *attr)
2319 struct pmbus_samples_reg *reg;
2321 reg = devm_kzalloc(data->dev, sizeof(*reg), GFP_KERNEL);
2328 pmbus_dev_attr_init(®->dev_attr, attr->name, 0644,
2329 pmbus_show_samples, pmbus_set_samples);
2331 return pmbus_add_attribute(data, ®->dev_attr.attr);
2334 static int pmbus_add_samples_attributes(struct i2c_client *client,
2335 struct pmbus_data *data)
2337 const struct pmbus_driver_info *info = data->info;
2340 if (!(info->func[0] & PMBUS_HAVE_SAMPLES))
2343 for (s = 0; s < ARRAY_SIZE(pmbus_samples_registers); s++) {
2344 struct pmbus_samples_attr *attr;
2347 attr = &pmbus_samples_registers[s];
2348 if (!pmbus_check_word_register(client, 0, attr->reg))
2351 ret = pmbus_add_samples_attr(data, 0, attr);
2359 static int pmbus_find_attributes(struct i2c_client *client,
2360 struct pmbus_data *data)
2364 /* Voltage sensors */
2365 ret = pmbus_add_sensor_attrs(client, data, "in", voltage_attributes,
2366 ARRAY_SIZE(voltage_attributes));
2370 /* Current sensors */
2371 ret = pmbus_add_sensor_attrs(client, data, "curr", current_attributes,
2372 ARRAY_SIZE(current_attributes));
2377 ret = pmbus_add_sensor_attrs(client, data, "power", power_attributes,
2378 ARRAY_SIZE(power_attributes));
2382 /* Temperature sensors */
2383 ret = pmbus_add_sensor_attrs(client, data, "temp", temp_attributes,
2384 ARRAY_SIZE(temp_attributes));
2389 ret = pmbus_add_fan_attributes(client, data);
2393 ret = pmbus_add_samples_attributes(client, data);
2398 * The pmbus_class_attr_map structure maps one sensor class to
2399 * it's corresponding sensor attributes array.
2401 struct pmbus_class_attr_map {
2402 enum pmbus_sensor_classes class;
2404 const struct pmbus_sensor_attr *attr;
2407 static const struct pmbus_class_attr_map class_attr_map[] = {
2409 .class = PSC_VOLTAGE_IN,
2410 .attr = voltage_attributes,
2411 .nattr = ARRAY_SIZE(voltage_attributes),
2413 .class = PSC_VOLTAGE_OUT,
2414 .attr = voltage_attributes,
2415 .nattr = ARRAY_SIZE(voltage_attributes),
2417 .class = PSC_CURRENT_IN,
2418 .attr = current_attributes,
2419 .nattr = ARRAY_SIZE(current_attributes),
2421 .class = PSC_CURRENT_OUT,
2422 .attr = current_attributes,
2423 .nattr = ARRAY_SIZE(current_attributes),
2426 .attr = power_attributes,
2427 .nattr = ARRAY_SIZE(power_attributes),
2429 .class = PSC_TEMPERATURE,
2430 .attr = temp_attributes,
2431 .nattr = ARRAY_SIZE(temp_attributes),
2436 * Read the coefficients for direct mode.
2438 static int pmbus_read_coefficients(struct i2c_client *client,
2439 struct pmbus_driver_info *info,
2440 const struct pmbus_sensor_attr *attr)
2443 union i2c_smbus_data data;
2444 enum pmbus_sensor_classes class = attr->class;
2449 data.block[1] = attr->reg;
2450 data.block[2] = 0x01;
2452 rv = i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2453 I2C_SMBUS_WRITE, PMBUS_COEFFICIENTS,
2454 I2C_SMBUS_BLOCK_PROC_CALL, &data);
2459 if (data.block[0] != 5)
2462 m = data.block[1] | (data.block[2] << 8);
2463 b = data.block[3] | (data.block[4] << 8);
2472 static int pmbus_init_coefficients(struct i2c_client *client,
2473 struct pmbus_driver_info *info)
2475 int i, n, ret = -EINVAL;
2476 const struct pmbus_class_attr_map *map;
2477 const struct pmbus_sensor_attr *attr;
2479 for (i = 0; i < ARRAY_SIZE(class_attr_map); i++) {
2480 map = &class_attr_map[i];
2481 if (info->format[map->class] != direct)
2483 for (n = 0; n < map->nattr; n++) {
2484 attr = &map->attr[n];
2485 if (map->class != attr->class)
2487 ret = pmbus_read_coefficients(client, info, attr);
2492 dev_err(&client->dev,
2493 "No coefficients found for sensor class %d\n",
2503 * Identify chip parameters.
2504 * This function is called for all chips.
2506 static int pmbus_identify_common(struct i2c_client *client,
2507 struct pmbus_data *data, int page)
2511 if (pmbus_check_byte_register(client, page, PMBUS_VOUT_MODE))
2512 vout_mode = _pmbus_read_byte_data(client, page,
2514 if (vout_mode >= 0 && vout_mode != 0xff) {
2516 * Not all chips support the VOUT_MODE command,
2517 * so a failure to read it is not an error.
2519 switch (vout_mode >> 5) {
2520 case 0: /* linear mode */
2521 if (data->info->format[PSC_VOLTAGE_OUT] != linear)
2524 data->exponent[page] = ((s8)(vout_mode << 3)) >> 3;
2526 case 1: /* VID mode */
2527 if (data->info->format[PSC_VOLTAGE_OUT] != vid)
2530 case 2: /* direct mode */
2531 if (data->info->format[PSC_VOLTAGE_OUT] != direct)
2534 case 3: /* ieee 754 half precision */
2535 if (data->info->format[PSC_VOLTAGE_OUT] != ieee754)
2543 pmbus_clear_fault_page(client, page);
2547 static int pmbus_read_status_byte(struct i2c_client *client, int page)
2549 return _pmbus_read_byte_data(client, page, PMBUS_STATUS_BYTE);
2552 static int pmbus_read_status_word(struct i2c_client *client, int page)
2554 return _pmbus_read_word_data(client, page, 0xff, PMBUS_STATUS_WORD);
2557 /* PEC attribute support */
2559 static ssize_t pec_show(struct device *dev, struct device_attribute *dummy,
2562 struct i2c_client *client = to_i2c_client(dev);
2564 return sysfs_emit(buf, "%d\n", !!(client->flags & I2C_CLIENT_PEC));
2567 static ssize_t pec_store(struct device *dev, struct device_attribute *dummy,
2568 const char *buf, size_t count)
2570 struct i2c_client *client = to_i2c_client(dev);
2574 err = kstrtobool(buf, &enable);
2579 client->flags |= I2C_CLIENT_PEC;
2581 client->flags &= ~I2C_CLIENT_PEC;
2586 static DEVICE_ATTR_RW(pec);
2588 static void pmbus_remove_pec(void *dev)
2590 device_remove_file(dev, &dev_attr_pec);
2593 static int pmbus_init_common(struct i2c_client *client, struct pmbus_data *data,
2594 struct pmbus_driver_info *info)
2596 struct device *dev = &client->dev;
2600 * Figure out if PEC is enabled before accessing any other register.
2601 * Make sure PEC is disabled, will be enabled later if needed.
2603 client->flags &= ~I2C_CLIENT_PEC;
2605 /* Enable PEC if the controller and bus supports it */
2606 if (!(data->flags & PMBUS_NO_CAPABILITY)) {
2607 ret = i2c_smbus_read_byte_data(client, PMBUS_CAPABILITY);
2608 if (ret >= 0 && (ret & PB_CAPABILITY_ERROR_CHECK)) {
2609 if (i2c_check_functionality(client->adapter, I2C_FUNC_SMBUS_PEC))
2610 client->flags |= I2C_CLIENT_PEC;
2615 * Some PMBus chips don't support PMBUS_STATUS_WORD, so try
2616 * to use PMBUS_STATUS_BYTE instead if that is the case.
2617 * Bail out if both registers are not supported.
2619 data->read_status = pmbus_read_status_word;
2620 ret = i2c_smbus_read_word_data(client, PMBUS_STATUS_WORD);
2621 if (ret < 0 || ret == 0xffff) {
2622 data->read_status = pmbus_read_status_byte;
2623 ret = i2c_smbus_read_byte_data(client, PMBUS_STATUS_BYTE);
2624 if (ret < 0 || ret == 0xff) {
2625 dev_err(dev, "PMBus status register not found\n");
2629 data->has_status_word = true;
2633 * Check if the chip is write protected. If it is, we can not clear
2634 * faults, and we should not try it. Also, in that case, writes into
2635 * limit registers need to be disabled.
2637 if (!(data->flags & PMBUS_NO_WRITE_PROTECT)) {
2638 ret = i2c_smbus_read_byte_data(client, PMBUS_WRITE_PROTECT);
2639 if (ret > 0 && (ret & PB_WP_ANY))
2640 data->flags |= PMBUS_WRITE_PROTECTED | PMBUS_SKIP_STATUS_CHECK;
2643 if (data->info->pages)
2644 pmbus_clear_faults(client);
2646 pmbus_clear_fault_page(client, -1);
2648 if (info->identify) {
2649 ret = (*info->identify)(client, info);
2651 dev_err(dev, "Chip identification failed\n");
2656 if (info->pages <= 0 || info->pages > PMBUS_PAGES) {
2657 dev_err(dev, "Bad number of PMBus pages: %d\n", info->pages);
2661 for (page = 0; page < info->pages; page++) {
2662 ret = pmbus_identify_common(client, data, page);
2664 dev_err(dev, "Failed to identify chip capabilities\n");
2669 if (data->flags & PMBUS_USE_COEFFICIENTS_CMD) {
2670 if (!i2c_check_functionality(client->adapter,
2671 I2C_FUNC_SMBUS_BLOCK_PROC_CALL))
2674 ret = pmbus_init_coefficients(client, info);
2679 if (client->flags & I2C_CLIENT_PEC) {
2681 * If I2C_CLIENT_PEC is set here, both the I2C adapter and the
2682 * chip support PEC. Add 'pec' attribute to client device to let
2683 * the user control it.
2685 ret = device_create_file(dev, &dev_attr_pec);
2688 ret = devm_add_action_or_reset(dev, pmbus_remove_pec, dev);
2696 /* A PMBus status flag and the corresponding REGULATOR_ERROR_* and REGULATOR_EVENTS_* flag */
2697 struct pmbus_status_assoc {
2698 int pflag, rflag, eflag;
2701 /* PMBus->regulator bit mappings for a PMBus status register */
2702 struct pmbus_status_category {
2705 const struct pmbus_status_assoc *bits; /* zero-terminated */
2708 static const struct pmbus_status_category __maybe_unused pmbus_status_flag_map[] = {
2710 .func = PMBUS_HAVE_STATUS_VOUT,
2711 .reg = PMBUS_STATUS_VOUT,
2712 .bits = (const struct pmbus_status_assoc[]) {
2713 { PB_VOLTAGE_UV_WARNING, REGULATOR_ERROR_UNDER_VOLTAGE_WARN,
2714 REGULATOR_EVENT_UNDER_VOLTAGE_WARN },
2715 { PB_VOLTAGE_UV_FAULT, REGULATOR_ERROR_UNDER_VOLTAGE,
2716 REGULATOR_EVENT_UNDER_VOLTAGE },
2717 { PB_VOLTAGE_OV_WARNING, REGULATOR_ERROR_OVER_VOLTAGE_WARN,
2718 REGULATOR_EVENT_OVER_VOLTAGE_WARN },
2719 { PB_VOLTAGE_OV_FAULT, REGULATOR_ERROR_REGULATION_OUT,
2720 REGULATOR_EVENT_OVER_VOLTAGE_WARN },
2724 .func = PMBUS_HAVE_STATUS_IOUT,
2725 .reg = PMBUS_STATUS_IOUT,
2726 .bits = (const struct pmbus_status_assoc[]) {
2727 { PB_IOUT_OC_WARNING, REGULATOR_ERROR_OVER_CURRENT_WARN,
2728 REGULATOR_EVENT_OVER_CURRENT_WARN },
2729 { PB_IOUT_OC_FAULT, REGULATOR_ERROR_OVER_CURRENT,
2730 REGULATOR_EVENT_OVER_CURRENT },
2731 { PB_IOUT_OC_LV_FAULT, REGULATOR_ERROR_OVER_CURRENT,
2732 REGULATOR_EVENT_OVER_CURRENT },
2736 .func = PMBUS_HAVE_STATUS_TEMP,
2737 .reg = PMBUS_STATUS_TEMPERATURE,
2738 .bits = (const struct pmbus_status_assoc[]) {
2739 { PB_TEMP_OT_WARNING, REGULATOR_ERROR_OVER_TEMP_WARN,
2740 REGULATOR_EVENT_OVER_TEMP_WARN },
2741 { PB_TEMP_OT_FAULT, REGULATOR_ERROR_OVER_TEMP,
2742 REGULATOR_EVENT_OVER_TEMP },
2748 static int _pmbus_is_enabled(struct device *dev, u8 page)
2750 struct i2c_client *client = to_i2c_client(dev->parent);
2753 ret = _pmbus_read_byte_data(client, page, PMBUS_OPERATION);
2758 return !!(ret & PB_OPERATION_CONTROL_ON);
2761 static int __maybe_unused pmbus_is_enabled(struct device *dev, u8 page)
2763 struct i2c_client *client = to_i2c_client(dev->parent);
2764 struct pmbus_data *data = i2c_get_clientdata(client);
2767 mutex_lock(&data->update_lock);
2768 ret = _pmbus_is_enabled(dev, page);
2769 mutex_unlock(&data->update_lock);
2771 return !!(ret & PB_OPERATION_CONTROL_ON);
2774 #define to_dev_attr(_dev_attr) \
2775 container_of(_dev_attr, struct device_attribute, attr)
2777 static void pmbus_notify(struct pmbus_data *data, int page, int reg, int flags)
2781 for (i = 0; i < data->num_attributes; i++) {
2782 struct device_attribute *da = to_dev_attr(data->group.attrs[i]);
2783 struct sensor_device_attribute *attr = to_sensor_dev_attr(da);
2784 int index = attr->index;
2785 u16 smask = pb_index_to_mask(index);
2786 u8 spage = pb_index_to_page(index);
2787 u16 sreg = pb_index_to_reg(index);
2789 if (reg == sreg && page == spage && (smask & flags)) {
2790 dev_dbg(data->dev, "sysfs notify: %s", da->attr.name);
2791 sysfs_notify(&data->dev->kobj, NULL, da->attr.name);
2792 kobject_uevent(&data->dev->kobj, KOBJ_CHANGE);
2801 static int _pmbus_get_flags(struct pmbus_data *data, u8 page, unsigned int *flags,
2802 unsigned int *event, bool notify)
2805 const struct pmbus_status_category *cat;
2806 const struct pmbus_status_assoc *bit;
2807 struct device *dev = data->dev;
2808 struct i2c_client *client = to_i2c_client(dev);
2809 int func = data->info->func[page];
2814 for (i = 0; i < ARRAY_SIZE(pmbus_status_flag_map); i++) {
2815 cat = &pmbus_status_flag_map[i];
2816 if (!(func & cat->func))
2819 status = _pmbus_read_byte_data(client, page, cat->reg);
2823 for (bit = cat->bits; bit->pflag; bit++)
2824 if (status & bit->pflag) {
2825 *flags |= bit->rflag;
2826 *event |= bit->eflag;
2829 if (notify && status)
2830 pmbus_notify(data, page, cat->reg, status);
2835 * Map what bits of STATUS_{WORD,BYTE} we can to REGULATOR_ERROR_*
2836 * bits. Some of the other bits are tempting (especially for cases
2837 * where we don't have the relevant PMBUS_HAVE_STATUS_*
2838 * functionality), but there's an unfortunate ambiguity in that
2839 * they're defined as indicating a fault *or* a warning, so we can't
2840 * easily determine whether to report REGULATOR_ERROR_<foo> or
2841 * REGULATOR_ERROR_<foo>_WARN.
2843 status = pmbus_get_status(client, page, PMBUS_STATUS_WORD);
2847 if (_pmbus_is_enabled(dev, page)) {
2848 if (status & PB_STATUS_OFF) {
2849 *flags |= REGULATOR_ERROR_FAIL;
2850 *event |= REGULATOR_EVENT_FAIL;
2853 if (status & PB_STATUS_POWER_GOOD_N) {
2854 *flags |= REGULATOR_ERROR_REGULATION_OUT;
2855 *event |= REGULATOR_EVENT_REGULATION_OUT;
2859 * Unlike most other status bits, PB_STATUS_{IOUT_OC,VOUT_OV} are
2860 * defined strictly as fault indicators (not warnings).
2862 if (status & PB_STATUS_IOUT_OC) {
2863 *flags |= REGULATOR_ERROR_OVER_CURRENT;
2864 *event |= REGULATOR_EVENT_OVER_CURRENT;
2866 if (status & PB_STATUS_VOUT_OV) {
2867 *flags |= REGULATOR_ERROR_REGULATION_OUT;
2868 *event |= REGULATOR_EVENT_FAIL;
2872 * If we haven't discovered any thermal faults or warnings via
2873 * PMBUS_STATUS_TEMPERATURE, map PB_STATUS_TEMPERATURE to a warning as
2874 * a (conservative) best-effort interpretation.
2876 if (!(*flags & (REGULATOR_ERROR_OVER_TEMP | REGULATOR_ERROR_OVER_TEMP_WARN)) &&
2877 (status & PB_STATUS_TEMPERATURE)) {
2878 *flags |= REGULATOR_ERROR_OVER_TEMP_WARN;
2879 *event |= REGULATOR_EVENT_OVER_TEMP_WARN;
2886 static int __maybe_unused pmbus_get_flags(struct pmbus_data *data, u8 page, unsigned int *flags,
2887 unsigned int *event, bool notify)
2891 mutex_lock(&data->update_lock);
2892 ret = _pmbus_get_flags(data, page, flags, event, notify);
2893 mutex_unlock(&data->update_lock);
2898 #if IS_ENABLED(CONFIG_REGULATOR)
2899 static int pmbus_regulator_is_enabled(struct regulator_dev *rdev)
2901 return pmbus_is_enabled(rdev_get_dev(rdev), rdev_get_id(rdev));
2904 static int _pmbus_regulator_on_off(struct regulator_dev *rdev, bool enable)
2906 struct device *dev = rdev_get_dev(rdev);
2907 struct i2c_client *client = to_i2c_client(dev->parent);
2908 struct pmbus_data *data = i2c_get_clientdata(client);
2909 u8 page = rdev_get_id(rdev);
2912 mutex_lock(&data->update_lock);
2913 ret = pmbus_update_byte_data(client, page, PMBUS_OPERATION,
2914 PB_OPERATION_CONTROL_ON,
2915 enable ? PB_OPERATION_CONTROL_ON : 0);
2916 mutex_unlock(&data->update_lock);
2921 static int pmbus_regulator_enable(struct regulator_dev *rdev)
2923 return _pmbus_regulator_on_off(rdev, 1);
2926 static int pmbus_regulator_disable(struct regulator_dev *rdev)
2928 return _pmbus_regulator_on_off(rdev, 0);
2931 static int pmbus_regulator_get_error_flags(struct regulator_dev *rdev, unsigned int *flags)
2933 struct device *dev = rdev_get_dev(rdev);
2934 struct i2c_client *client = to_i2c_client(dev->parent);
2935 struct pmbus_data *data = i2c_get_clientdata(client);
2938 return pmbus_get_flags(data, rdev_get_id(rdev), flags, &event, false);
2941 static int pmbus_regulator_get_status(struct regulator_dev *rdev)
2943 struct device *dev = rdev_get_dev(rdev);
2944 struct i2c_client *client = to_i2c_client(dev->parent);
2945 struct pmbus_data *data = i2c_get_clientdata(client);
2946 u8 page = rdev_get_id(rdev);
2949 mutex_lock(&data->update_lock);
2950 status = pmbus_get_status(client, page, PMBUS_STATUS_WORD);
2956 if (status & PB_STATUS_OFF) {
2957 ret = REGULATOR_STATUS_OFF;
2961 /* If regulator is ON & reports power good then return ON */
2962 if (!(status & PB_STATUS_POWER_GOOD_N)) {
2963 ret = REGULATOR_STATUS_ON;
2967 ret = pmbus_regulator_get_error_flags(rdev, &status);
2971 if (status & (REGULATOR_ERROR_UNDER_VOLTAGE | REGULATOR_ERROR_OVER_CURRENT |
2972 REGULATOR_ERROR_REGULATION_OUT | REGULATOR_ERROR_FAIL | REGULATOR_ERROR_OVER_TEMP)) {
2973 ret = REGULATOR_STATUS_ERROR;
2977 ret = REGULATOR_STATUS_UNDEFINED;
2980 mutex_unlock(&data->update_lock);
2984 static int pmbus_regulator_get_low_margin(struct i2c_client *client, int page)
2986 struct pmbus_data *data = i2c_get_clientdata(client);
2987 struct pmbus_sensor s = {
2989 .class = PSC_VOLTAGE_OUT,
2994 if (data->vout_low[page] < 0) {
2995 if (pmbus_check_word_register(client, page, PMBUS_MFR_VOUT_MIN))
2996 s.data = _pmbus_read_word_data(client, page, 0xff,
2997 PMBUS_MFR_VOUT_MIN);
2999 s.data = _pmbus_read_word_data(client, page, 0xff,
3000 PMBUS_VOUT_MARGIN_LOW);
3004 data->vout_low[page] = pmbus_reg2data(data, &s);
3007 return data->vout_low[page];
3010 static int pmbus_regulator_get_high_margin(struct i2c_client *client, int page)
3012 struct pmbus_data *data = i2c_get_clientdata(client);
3013 struct pmbus_sensor s = {
3015 .class = PSC_VOLTAGE_OUT,
3020 if (data->vout_high[page] < 0) {
3021 if (pmbus_check_word_register(client, page, PMBUS_MFR_VOUT_MAX))
3022 s.data = _pmbus_read_word_data(client, page, 0xff,
3023 PMBUS_MFR_VOUT_MAX);
3025 s.data = _pmbus_read_word_data(client, page, 0xff,
3026 PMBUS_VOUT_MARGIN_HIGH);
3030 data->vout_high[page] = pmbus_reg2data(data, &s);
3033 return data->vout_high[page];
3036 static int pmbus_regulator_get_voltage(struct regulator_dev *rdev)
3038 struct device *dev = rdev_get_dev(rdev);
3039 struct i2c_client *client = to_i2c_client(dev->parent);
3040 struct pmbus_data *data = i2c_get_clientdata(client);
3041 struct pmbus_sensor s = {
3042 .page = rdev_get_id(rdev),
3043 .class = PSC_VOLTAGE_OUT,
3047 s.data = _pmbus_read_word_data(client, s.page, 0xff, PMBUS_READ_VOUT);
3051 return (int)pmbus_reg2data(data, &s) * 1000; /* unit is uV */
3054 static int pmbus_regulator_set_voltage(struct regulator_dev *rdev, int min_uv,
3055 int max_uv, unsigned int *selector)
3057 struct device *dev = rdev_get_dev(rdev);
3058 struct i2c_client *client = to_i2c_client(dev->parent);
3059 struct pmbus_data *data = i2c_get_clientdata(client);
3060 struct pmbus_sensor s = {
3061 .page = rdev_get_id(rdev),
3062 .class = PSC_VOLTAGE_OUT,
3066 int val = DIV_ROUND_CLOSEST(min_uv, 1000); /* convert to mV */
3071 low = pmbus_regulator_get_low_margin(client, s.page);
3075 high = pmbus_regulator_get_high_margin(client, s.page);
3079 /* Make sure we are within margins */
3085 val = pmbus_data2reg(data, &s, val);
3087 return _pmbus_write_word_data(client, s.page, PMBUS_VOUT_COMMAND, (u16)val);
3090 static int pmbus_regulator_list_voltage(struct regulator_dev *rdev,
3091 unsigned int selector)
3093 struct device *dev = rdev_get_dev(rdev);
3094 struct i2c_client *client = to_i2c_client(dev->parent);
3097 if (selector >= rdev->desc->n_voltages ||
3098 selector < rdev->desc->linear_min_sel)
3101 selector -= rdev->desc->linear_min_sel;
3102 val = DIV_ROUND_CLOSEST(rdev->desc->min_uV +
3103 (rdev->desc->uV_step * selector), 1000); /* convert to mV */
3105 low = pmbus_regulator_get_low_margin(client, rdev_get_id(rdev));
3109 high = pmbus_regulator_get_high_margin(client, rdev_get_id(rdev));
3113 if (val >= low && val <= high)
3114 return val * 1000; /* unit is uV */
3119 const struct regulator_ops pmbus_regulator_ops = {
3120 .enable = pmbus_regulator_enable,
3121 .disable = pmbus_regulator_disable,
3122 .is_enabled = pmbus_regulator_is_enabled,
3123 .get_error_flags = pmbus_regulator_get_error_flags,
3124 .get_status = pmbus_regulator_get_status,
3125 .get_voltage = pmbus_regulator_get_voltage,
3126 .set_voltage = pmbus_regulator_set_voltage,
3127 .list_voltage = pmbus_regulator_list_voltage,
3129 EXPORT_SYMBOL_NS_GPL(pmbus_regulator_ops, PMBUS);
3131 static int pmbus_regulator_register(struct pmbus_data *data)
3133 struct device *dev = data->dev;
3134 const struct pmbus_driver_info *info = data->info;
3135 const struct pmbus_platform_data *pdata = dev_get_platdata(dev);
3138 data->rdevs = devm_kzalloc(dev, sizeof(struct regulator_dev *) * info->num_regulators,
3143 for (i = 0; i < info->num_regulators; i++) {
3144 struct regulator_config config = { };
3147 config.driver_data = data;
3149 if (pdata && pdata->reg_init_data)
3150 config.init_data = &pdata->reg_init_data[i];
3152 data->rdevs[i] = devm_regulator_register(dev, &info->reg_desc[i],
3154 if (IS_ERR(data->rdevs[i]))
3155 return dev_err_probe(dev, PTR_ERR(data->rdevs[i]),
3156 "Failed to register %s regulator\n",
3157 info->reg_desc[i].name);
3163 static int pmbus_regulator_notify(struct pmbus_data *data, int page, int event)
3167 for (j = 0; j < data->info->num_regulators; j++) {
3168 if (page == rdev_get_id(data->rdevs[j])) {
3169 regulator_notifier_call_chain(data->rdevs[j], event, NULL);
3176 static int pmbus_regulator_register(struct pmbus_data *data)
3181 static int pmbus_regulator_notify(struct pmbus_data *data, int page, int event)
3187 static int pmbus_write_smbalert_mask(struct i2c_client *client, u8 page, u8 reg, u8 val)
3189 return pmbus_write_word_data(client, page, PMBUS_SMBALERT_MASK, reg | (val << 8));
3192 static irqreturn_t pmbus_fault_handler(int irq, void *pdata)
3194 struct pmbus_data *data = pdata;
3195 struct i2c_client *client = to_i2c_client(data->dev);
3197 int i, status, event;
3198 mutex_lock(&data->update_lock);
3199 for (i = 0; i < data->info->pages; i++) {
3200 _pmbus_get_flags(data, i, &status, &event, true);
3203 pmbus_regulator_notify(data, i, event);
3206 pmbus_clear_faults(client);
3207 mutex_unlock(&data->update_lock);
3212 static int pmbus_irq_setup(struct i2c_client *client, struct pmbus_data *data)
3214 struct device *dev = &client->dev;
3215 const struct pmbus_status_category *cat;
3216 const struct pmbus_status_assoc *bit;
3217 int i, j, err, func;
3220 static const u8 misc_status[] = {PMBUS_STATUS_CML, PMBUS_STATUS_OTHER,
3221 PMBUS_STATUS_MFR_SPECIFIC, PMBUS_STATUS_FAN_12,
3222 PMBUS_STATUS_FAN_34};
3227 for (i = 0; i < data->info->pages; i++) {
3228 func = data->info->func[i];
3230 for (j = 0; j < ARRAY_SIZE(pmbus_status_flag_map); j++) {
3231 cat = &pmbus_status_flag_map[j];
3232 if (!(func & cat->func))
3235 for (bit = cat->bits; bit->pflag; bit++)
3238 err = pmbus_write_smbalert_mask(client, i, cat->reg, ~mask);
3240 dev_dbg_once(dev, "Failed to set smbalert for reg 0x%02x\n",
3244 for (j = 0; j < ARRAY_SIZE(misc_status); j++)
3245 pmbus_write_smbalert_mask(client, i, misc_status[j], 0xff);
3248 /* Register notifiers */
3249 err = devm_request_threaded_irq(dev, client->irq, NULL, pmbus_fault_handler,
3250 IRQF_ONESHOT, "pmbus-irq", data);
3252 dev_err(dev, "failed to request an irq %d\n", err);
3259 static struct dentry *pmbus_debugfs_dir; /* pmbus debugfs directory */
3261 #if IS_ENABLED(CONFIG_DEBUG_FS)
3262 static int pmbus_debugfs_get(void *data, u64 *val)
3265 struct pmbus_debugfs_entry *entry = data;
3266 struct pmbus_data *pdata = i2c_get_clientdata(entry->client);
3268 rc = mutex_lock_interruptible(&pdata->update_lock);
3271 rc = _pmbus_read_byte_data(entry->client, entry->page, entry->reg);
3272 mutex_unlock(&pdata->update_lock);
3280 DEFINE_DEBUGFS_ATTRIBUTE(pmbus_debugfs_ops, pmbus_debugfs_get, NULL,
3283 static int pmbus_debugfs_get_status(void *data, u64 *val)
3286 struct pmbus_debugfs_entry *entry = data;
3287 struct pmbus_data *pdata = i2c_get_clientdata(entry->client);
3289 rc = mutex_lock_interruptible(&pdata->update_lock);
3292 rc = pdata->read_status(entry->client, entry->page);
3293 mutex_unlock(&pdata->update_lock);
3301 DEFINE_DEBUGFS_ATTRIBUTE(pmbus_debugfs_ops_status, pmbus_debugfs_get_status,
3302 NULL, "0x%04llx\n");
3304 static ssize_t pmbus_debugfs_mfr_read(struct file *file, char __user *buf,
3305 size_t count, loff_t *ppos)
3308 struct pmbus_debugfs_entry *entry = file->private_data;
3309 struct pmbus_data *pdata = i2c_get_clientdata(entry->client);
3310 char data[I2C_SMBUS_BLOCK_MAX + 2] = { 0 };
3312 rc = mutex_lock_interruptible(&pdata->update_lock);
3315 rc = pmbus_read_block_data(entry->client, entry->page, entry->reg,
3317 mutex_unlock(&pdata->update_lock);
3321 /* Add newline at the end of a read data */
3324 /* Include newline into the length */
3327 return simple_read_from_buffer(buf, count, ppos, data, rc);
3330 static const struct file_operations pmbus_debugfs_ops_mfr = {
3331 .llseek = noop_llseek,
3332 .read = pmbus_debugfs_mfr_read,
3334 .open = simple_open,
3337 static void pmbus_remove_debugfs(void *data)
3339 struct dentry *entry = data;
3341 debugfs_remove_recursive(entry);
3344 static int pmbus_init_debugfs(struct i2c_client *client,
3345 struct pmbus_data *data)
3348 char name[PMBUS_NAME_SIZE];
3349 struct pmbus_debugfs_entry *entries;
3351 if (!pmbus_debugfs_dir)
3355 * Create the debugfs directory for this device. Use the hwmon device
3356 * name to avoid conflicts (hwmon numbers are globally unique).
3358 data->debugfs = debugfs_create_dir(dev_name(data->hwmon_dev),
3360 if (IS_ERR_OR_NULL(data->debugfs)) {
3361 data->debugfs = NULL;
3366 * Allocate the max possible entries we need.
3367 * 6 entries device-specific
3368 * 10 entries page-specific
3370 entries = devm_kcalloc(data->dev,
3371 6 + data->info->pages * 10, sizeof(*entries),
3377 * Add device-specific entries.
3378 * Please note that the PMBUS standard allows all registers to be
3380 * To reduce the number of debugfs entries for devices with many pages
3381 * assume that values of the following registers are the same for all
3382 * pages and report values only for page 0.
3384 if (pmbus_check_block_register(client, 0, PMBUS_MFR_ID)) {
3385 entries[idx].client = client;
3386 entries[idx].page = 0;
3387 entries[idx].reg = PMBUS_MFR_ID;
3388 debugfs_create_file("mfr_id", 0444, data->debugfs,
3390 &pmbus_debugfs_ops_mfr);
3393 if (pmbus_check_block_register(client, 0, PMBUS_MFR_MODEL)) {
3394 entries[idx].client = client;
3395 entries[idx].page = 0;
3396 entries[idx].reg = PMBUS_MFR_MODEL;
3397 debugfs_create_file("mfr_model", 0444, data->debugfs,
3399 &pmbus_debugfs_ops_mfr);
3402 if (pmbus_check_block_register(client, 0, PMBUS_MFR_REVISION)) {
3403 entries[idx].client = client;
3404 entries[idx].page = 0;
3405 entries[idx].reg = PMBUS_MFR_REVISION;
3406 debugfs_create_file("mfr_revision", 0444, data->debugfs,
3408 &pmbus_debugfs_ops_mfr);
3411 if (pmbus_check_block_register(client, 0, PMBUS_MFR_LOCATION)) {
3412 entries[idx].client = client;
3413 entries[idx].page = 0;
3414 entries[idx].reg = PMBUS_MFR_LOCATION;
3415 debugfs_create_file("mfr_location", 0444, data->debugfs,
3417 &pmbus_debugfs_ops_mfr);
3420 if (pmbus_check_block_register(client, 0, PMBUS_MFR_DATE)) {
3421 entries[idx].client = client;
3422 entries[idx].page = 0;
3423 entries[idx].reg = PMBUS_MFR_DATE;
3424 debugfs_create_file("mfr_date", 0444, data->debugfs,
3426 &pmbus_debugfs_ops_mfr);
3429 if (pmbus_check_block_register(client, 0, PMBUS_MFR_SERIAL)) {
3430 entries[idx].client = client;
3431 entries[idx].page = 0;
3432 entries[idx].reg = PMBUS_MFR_SERIAL;
3433 debugfs_create_file("mfr_serial", 0444, data->debugfs,
3435 &pmbus_debugfs_ops_mfr);
3438 /* Add page specific entries */
3439 for (i = 0; i < data->info->pages; ++i) {
3440 /* Check accessibility of status register if it's not page 0 */
3441 if (!i || pmbus_check_status_register(client, i)) {
3442 /* No need to set reg as we have special read op. */
3443 entries[idx].client = client;
3444 entries[idx].page = i;
3445 scnprintf(name, PMBUS_NAME_SIZE, "status%d", i);
3446 debugfs_create_file(name, 0444, data->debugfs,
3448 &pmbus_debugfs_ops_status);
3451 if (data->info->func[i] & PMBUS_HAVE_STATUS_VOUT) {
3452 entries[idx].client = client;
3453 entries[idx].page = i;
3454 entries[idx].reg = PMBUS_STATUS_VOUT;
3455 scnprintf(name, PMBUS_NAME_SIZE, "status%d_vout", i);
3456 debugfs_create_file(name, 0444, data->debugfs,
3458 &pmbus_debugfs_ops);
3461 if (data->info->func[i] & PMBUS_HAVE_STATUS_IOUT) {
3462 entries[idx].client = client;
3463 entries[idx].page = i;
3464 entries[idx].reg = PMBUS_STATUS_IOUT;
3465 scnprintf(name, PMBUS_NAME_SIZE, "status%d_iout", i);
3466 debugfs_create_file(name, 0444, data->debugfs,
3468 &pmbus_debugfs_ops);
3471 if (data->info->func[i] & PMBUS_HAVE_STATUS_INPUT) {
3472 entries[idx].client = client;
3473 entries[idx].page = i;
3474 entries[idx].reg = PMBUS_STATUS_INPUT;
3475 scnprintf(name, PMBUS_NAME_SIZE, "status%d_input", i);
3476 debugfs_create_file(name, 0444, data->debugfs,
3478 &pmbus_debugfs_ops);
3481 if (data->info->func[i] & PMBUS_HAVE_STATUS_TEMP) {
3482 entries[idx].client = client;
3483 entries[idx].page = i;
3484 entries[idx].reg = PMBUS_STATUS_TEMPERATURE;
3485 scnprintf(name, PMBUS_NAME_SIZE, "status%d_temp", i);
3486 debugfs_create_file(name, 0444, data->debugfs,
3488 &pmbus_debugfs_ops);
3491 if (pmbus_check_byte_register(client, i, PMBUS_STATUS_CML)) {
3492 entries[idx].client = client;
3493 entries[idx].page = i;
3494 entries[idx].reg = PMBUS_STATUS_CML;
3495 scnprintf(name, PMBUS_NAME_SIZE, "status%d_cml", i);
3496 debugfs_create_file(name, 0444, data->debugfs,
3498 &pmbus_debugfs_ops);
3501 if (pmbus_check_byte_register(client, i, PMBUS_STATUS_OTHER)) {
3502 entries[idx].client = client;
3503 entries[idx].page = i;
3504 entries[idx].reg = PMBUS_STATUS_OTHER;
3505 scnprintf(name, PMBUS_NAME_SIZE, "status%d_other", i);
3506 debugfs_create_file(name, 0444, data->debugfs,
3508 &pmbus_debugfs_ops);
3511 if (pmbus_check_byte_register(client, i,
3512 PMBUS_STATUS_MFR_SPECIFIC)) {
3513 entries[idx].client = client;
3514 entries[idx].page = i;
3515 entries[idx].reg = PMBUS_STATUS_MFR_SPECIFIC;
3516 scnprintf(name, PMBUS_NAME_SIZE, "status%d_mfr", i);
3517 debugfs_create_file(name, 0444, data->debugfs,
3519 &pmbus_debugfs_ops);
3522 if (data->info->func[i] & PMBUS_HAVE_STATUS_FAN12) {
3523 entries[idx].client = client;
3524 entries[idx].page = i;
3525 entries[idx].reg = PMBUS_STATUS_FAN_12;
3526 scnprintf(name, PMBUS_NAME_SIZE, "status%d_fan12", i);
3527 debugfs_create_file(name, 0444, data->debugfs,
3529 &pmbus_debugfs_ops);
3532 if (data->info->func[i] & PMBUS_HAVE_STATUS_FAN34) {
3533 entries[idx].client = client;
3534 entries[idx].page = i;
3535 entries[idx].reg = PMBUS_STATUS_FAN_34;
3536 scnprintf(name, PMBUS_NAME_SIZE, "status%d_fan34", i);
3537 debugfs_create_file(name, 0444, data->debugfs,
3539 &pmbus_debugfs_ops);
3543 return devm_add_action_or_reset(data->dev,
3544 pmbus_remove_debugfs, data->debugfs);
3547 static int pmbus_init_debugfs(struct i2c_client *client,
3548 struct pmbus_data *data)
3552 #endif /* IS_ENABLED(CONFIG_DEBUG_FS) */
3554 int pmbus_do_probe(struct i2c_client *client, struct pmbus_driver_info *info)
3556 struct device *dev = &client->dev;
3557 const struct pmbus_platform_data *pdata = dev_get_platdata(dev);
3558 struct pmbus_data *data;
3559 size_t groups_num = 0;
3567 if (!i2c_check_functionality(client->adapter, I2C_FUNC_SMBUS_WRITE_BYTE
3568 | I2C_FUNC_SMBUS_BYTE_DATA
3569 | I2C_FUNC_SMBUS_WORD_DATA))
3572 data = devm_kzalloc(dev, sizeof(*data), GFP_KERNEL);
3577 while (info->groups[groups_num])
3580 data->groups = devm_kcalloc(dev, groups_num + 2, sizeof(void *),
3585 i2c_set_clientdata(client, data);
3586 mutex_init(&data->update_lock);
3590 data->flags = pdata->flags;
3592 data->currpage = -1;
3593 data->currphase = -1;
3595 for (i = 0; i < ARRAY_SIZE(data->vout_low); i++) {
3596 data->vout_low[i] = -1;
3597 data->vout_high[i] = -1;
3600 ret = pmbus_init_common(client, data, info);
3604 ret = pmbus_find_attributes(client, data);
3609 * If there are no attributes, something is wrong.
3610 * Bail out instead of trying to register nothing.
3612 if (!data->num_attributes) {
3613 dev_err(dev, "No attributes found\n");
3617 name = devm_kstrdup(dev, client->name, GFP_KERNEL);
3620 strreplace(name, '-', '_');
3622 data->groups[0] = &data->group;
3623 memcpy(data->groups + 1, info->groups, sizeof(void *) * groups_num);
3624 data->hwmon_dev = devm_hwmon_device_register_with_groups(dev,
3625 name, data, data->groups);
3626 if (IS_ERR(data->hwmon_dev)) {
3627 dev_err(dev, "Failed to register hwmon device\n");
3628 return PTR_ERR(data->hwmon_dev);
3631 ret = pmbus_regulator_register(data);
3635 ret = pmbus_irq_setup(client, data);
3639 ret = pmbus_init_debugfs(client, data);
3641 dev_warn(dev, "Failed to register debugfs\n");
3645 EXPORT_SYMBOL_NS_GPL(pmbus_do_probe, PMBUS);
3647 struct dentry *pmbus_get_debugfs_dir(struct i2c_client *client)
3649 struct pmbus_data *data = i2c_get_clientdata(client);
3651 return data->debugfs;
3653 EXPORT_SYMBOL_NS_GPL(pmbus_get_debugfs_dir, PMBUS);
3655 int pmbus_lock_interruptible(struct i2c_client *client)
3657 struct pmbus_data *data = i2c_get_clientdata(client);
3659 return mutex_lock_interruptible(&data->update_lock);
3661 EXPORT_SYMBOL_NS_GPL(pmbus_lock_interruptible, PMBUS);
3663 void pmbus_unlock(struct i2c_client *client)
3665 struct pmbus_data *data = i2c_get_clientdata(client);
3667 mutex_unlock(&data->update_lock);
3669 EXPORT_SYMBOL_NS_GPL(pmbus_unlock, PMBUS);
3671 static int __init pmbus_core_init(void)
3673 pmbus_debugfs_dir = debugfs_create_dir("pmbus", NULL);
3674 if (IS_ERR(pmbus_debugfs_dir))
3675 pmbus_debugfs_dir = NULL;
3680 static void __exit pmbus_core_exit(void)
3682 debugfs_remove_recursive(pmbus_debugfs_dir);
3685 module_init(pmbus_core_init);
3686 module_exit(pmbus_core_exit);
3688 MODULE_AUTHOR("Guenter Roeck");
3689 MODULE_DESCRIPTION("PMBus core driver");
3690 MODULE_LICENSE("GPL");