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>
25 * Number of additional attribute pointers to allocate
26 * with each call to krealloc
28 #define PMBUS_ATTR_ALLOC_SIZE 32
29 #define PMBUS_NAME_SIZE 24
32 struct pmbus_sensor *next;
33 char name[PMBUS_NAME_SIZE]; /* sysfs sensor name */
34 struct device_attribute attribute;
35 u8 page; /* page number */
36 u8 phase; /* phase number, 0xff for all phases */
37 u16 reg; /* register */
38 enum pmbus_sensor_classes class; /* sensor class */
39 bool update; /* runtime sensor update needed */
40 bool convert; /* Whether or not to apply linear/vid/direct */
41 int data; /* Sensor data.
42 Negative if there was a read error */
44 #define to_pmbus_sensor(_attr) \
45 container_of(_attr, struct pmbus_sensor, attribute)
47 struct pmbus_boolean {
48 char name[PMBUS_NAME_SIZE]; /* sysfs boolean name */
49 struct sensor_device_attribute attribute;
50 struct pmbus_sensor *s1;
51 struct pmbus_sensor *s2;
53 #define to_pmbus_boolean(_attr) \
54 container_of(_attr, struct pmbus_boolean, attribute)
57 char name[PMBUS_NAME_SIZE]; /* sysfs label name */
58 struct device_attribute attribute;
59 char label[PMBUS_NAME_SIZE]; /* label */
61 #define to_pmbus_label(_attr) \
62 container_of(_attr, struct pmbus_label, attribute)
64 /* Macros for converting between sensor index and register/page/status mask */
66 #define PB_STATUS_MASK 0xffff
67 #define PB_REG_SHIFT 16
68 #define PB_REG_MASK 0x3ff
69 #define PB_PAGE_SHIFT 26
70 #define PB_PAGE_MASK 0x3f
72 #define pb_reg_to_index(page, reg, mask) (((page) << PB_PAGE_SHIFT) | \
73 ((reg) << PB_REG_SHIFT) | (mask))
75 #define pb_index_to_page(index) (((index) >> PB_PAGE_SHIFT) & PB_PAGE_MASK)
76 #define pb_index_to_reg(index) (((index) >> PB_REG_SHIFT) & PB_REG_MASK)
77 #define pb_index_to_mask(index) ((index) & PB_STATUS_MASK)
81 struct device *hwmon_dev;
83 u32 flags; /* from platform data */
85 int exponent[PMBUS_PAGES];
86 /* linear mode: exponent for output voltages */
88 const struct pmbus_driver_info *info;
92 struct attribute_group group;
93 const struct attribute_group **groups;
94 struct dentry *debugfs; /* debugfs device directory */
96 struct pmbus_sensor *sensors;
98 struct mutex update_lock;
100 bool has_status_word; /* device uses STATUS_WORD register */
101 int (*read_status)(struct i2c_client *client, int page);
103 s16 currpage; /* current page, -1 for unknown/unset */
104 s16 currphase; /* current phase, 0xff for all, -1 for unknown/unset */
107 struct pmbus_debugfs_entry {
108 struct i2c_client *client;
113 static const int pmbus_fan_rpm_mask[] = {
120 static const int pmbus_fan_config_registers[] = {
127 static const int pmbus_fan_command_registers[] = {
134 void pmbus_clear_cache(struct i2c_client *client)
136 struct pmbus_data *data = i2c_get_clientdata(client);
137 struct pmbus_sensor *sensor;
139 for (sensor = data->sensors; sensor; sensor = sensor->next)
140 sensor->data = -ENODATA;
142 EXPORT_SYMBOL_NS_GPL(pmbus_clear_cache, PMBUS);
144 void pmbus_set_update(struct i2c_client *client, u8 reg, bool update)
146 struct pmbus_data *data = i2c_get_clientdata(client);
147 struct pmbus_sensor *sensor;
149 for (sensor = data->sensors; sensor; sensor = sensor->next)
150 if (sensor->reg == reg)
151 sensor->update = update;
153 EXPORT_SYMBOL_NS_GPL(pmbus_set_update, PMBUS);
155 int pmbus_set_page(struct i2c_client *client, int page, int phase)
157 struct pmbus_data *data = i2c_get_clientdata(client);
163 if (!(data->info->func[page] & PMBUS_PAGE_VIRTUAL) &&
164 data->info->pages > 1 && page != data->currpage) {
165 rv = i2c_smbus_write_byte_data(client, PMBUS_PAGE, page);
169 rv = i2c_smbus_read_byte_data(client, PMBUS_PAGE);
176 data->currpage = page;
178 if (data->info->phases[page] && data->currphase != phase &&
179 !(data->info->func[page] & PMBUS_PHASE_VIRTUAL)) {
180 rv = i2c_smbus_write_byte_data(client, PMBUS_PHASE,
185 data->currphase = phase;
189 EXPORT_SYMBOL_NS_GPL(pmbus_set_page, PMBUS);
191 int pmbus_write_byte(struct i2c_client *client, int page, u8 value)
195 rv = pmbus_set_page(client, page, 0xff);
199 return i2c_smbus_write_byte(client, value);
201 EXPORT_SYMBOL_NS_GPL(pmbus_write_byte, PMBUS);
204 * _pmbus_write_byte() is similar to pmbus_write_byte(), but checks if
205 * a device specific mapping function exists and calls it if necessary.
207 static int _pmbus_write_byte(struct i2c_client *client, int page, u8 value)
209 struct pmbus_data *data = i2c_get_clientdata(client);
210 const struct pmbus_driver_info *info = data->info;
213 if (info->write_byte) {
214 status = info->write_byte(client, page, value);
215 if (status != -ENODATA)
218 return pmbus_write_byte(client, page, value);
221 int pmbus_write_word_data(struct i2c_client *client, int page, u8 reg,
226 rv = pmbus_set_page(client, page, 0xff);
230 return i2c_smbus_write_word_data(client, reg, word);
232 EXPORT_SYMBOL_NS_GPL(pmbus_write_word_data, PMBUS);
235 static int pmbus_write_virt_reg(struct i2c_client *client, int page, int reg,
243 case PMBUS_VIRT_FAN_TARGET_1 ... PMBUS_VIRT_FAN_TARGET_4:
244 id = reg - PMBUS_VIRT_FAN_TARGET_1;
245 bit = pmbus_fan_rpm_mask[id];
246 rv = pmbus_update_fan(client, page, id, bit, bit, word);
257 * _pmbus_write_word_data() is similar to pmbus_write_word_data(), but checks if
258 * a device specific mapping function exists and calls it if necessary.
260 static int _pmbus_write_word_data(struct i2c_client *client, int page, int reg,
263 struct pmbus_data *data = i2c_get_clientdata(client);
264 const struct pmbus_driver_info *info = data->info;
267 if (info->write_word_data) {
268 status = info->write_word_data(client, page, reg, word);
269 if (status != -ENODATA)
273 if (reg >= PMBUS_VIRT_BASE)
274 return pmbus_write_virt_reg(client, page, reg, word);
276 return pmbus_write_word_data(client, page, reg, word);
279 int pmbus_update_fan(struct i2c_client *client, int page, int id,
280 u8 config, u8 mask, u16 command)
286 from = pmbus_read_byte_data(client, page,
287 pmbus_fan_config_registers[id]);
291 to = (from & ~mask) | (config & mask);
293 rv = pmbus_write_byte_data(client, page,
294 pmbus_fan_config_registers[id], to);
299 return _pmbus_write_word_data(client, page,
300 pmbus_fan_command_registers[id], command);
302 EXPORT_SYMBOL_NS_GPL(pmbus_update_fan, PMBUS);
304 int pmbus_read_word_data(struct i2c_client *client, int page, int phase, u8 reg)
308 rv = pmbus_set_page(client, page, phase);
312 return i2c_smbus_read_word_data(client, reg);
314 EXPORT_SYMBOL_NS_GPL(pmbus_read_word_data, PMBUS);
316 static int pmbus_read_virt_reg(struct i2c_client *client, int page, int reg)
322 case PMBUS_VIRT_FAN_TARGET_1 ... PMBUS_VIRT_FAN_TARGET_4:
323 id = reg - PMBUS_VIRT_FAN_TARGET_1;
324 rv = pmbus_get_fan_rate_device(client, page, id, rpm);
335 * _pmbus_read_word_data() is similar to pmbus_read_word_data(), but checks if
336 * a device specific mapping function exists and calls it if necessary.
338 static int _pmbus_read_word_data(struct i2c_client *client, int page,
341 struct pmbus_data *data = i2c_get_clientdata(client);
342 const struct pmbus_driver_info *info = data->info;
345 if (info->read_word_data) {
346 status = info->read_word_data(client, page, phase, reg);
347 if (status != -ENODATA)
351 if (reg >= PMBUS_VIRT_BASE)
352 return pmbus_read_virt_reg(client, page, reg);
354 return pmbus_read_word_data(client, page, phase, reg);
357 /* Same as above, but without phase parameter, for use in check functions */
358 static int __pmbus_read_word_data(struct i2c_client *client, int page, int reg)
360 return _pmbus_read_word_data(client, page, 0xff, reg);
363 int pmbus_read_byte_data(struct i2c_client *client, int page, u8 reg)
367 rv = pmbus_set_page(client, page, 0xff);
371 return i2c_smbus_read_byte_data(client, reg);
373 EXPORT_SYMBOL_NS_GPL(pmbus_read_byte_data, PMBUS);
375 int pmbus_write_byte_data(struct i2c_client *client, int page, u8 reg, u8 value)
379 rv = pmbus_set_page(client, page, 0xff);
383 return i2c_smbus_write_byte_data(client, reg, value);
385 EXPORT_SYMBOL_NS_GPL(pmbus_write_byte_data, PMBUS);
387 int pmbus_update_byte_data(struct i2c_client *client, int page, u8 reg,
393 rv = pmbus_read_byte_data(client, page, reg);
397 tmp = (rv & ~mask) | (value & mask);
400 rv = pmbus_write_byte_data(client, page, reg, tmp);
404 EXPORT_SYMBOL_NS_GPL(pmbus_update_byte_data, PMBUS);
407 * _pmbus_read_byte_data() is similar to pmbus_read_byte_data(), but checks if
408 * a device specific mapping function exists and calls it if necessary.
410 static int _pmbus_read_byte_data(struct i2c_client *client, int page, int reg)
412 struct pmbus_data *data = i2c_get_clientdata(client);
413 const struct pmbus_driver_info *info = data->info;
416 if (info->read_byte_data) {
417 status = info->read_byte_data(client, page, reg);
418 if (status != -ENODATA)
421 return pmbus_read_byte_data(client, page, reg);
424 static struct pmbus_sensor *pmbus_find_sensor(struct pmbus_data *data, int page,
427 struct pmbus_sensor *sensor;
429 for (sensor = data->sensors; sensor; sensor = sensor->next) {
430 if (sensor->page == page && sensor->reg == reg)
434 return ERR_PTR(-EINVAL);
437 static int pmbus_get_fan_rate(struct i2c_client *client, int page, int id,
438 enum pmbus_fan_mode mode,
441 struct pmbus_data *data = i2c_get_clientdata(client);
442 bool want_rpm, have_rpm;
443 struct pmbus_sensor *s;
447 want_rpm = (mode == rpm);
450 reg = want_rpm ? PMBUS_VIRT_FAN_TARGET_1 : PMBUS_VIRT_PWM_1;
451 s = pmbus_find_sensor(data, page, reg + id);
458 config = pmbus_read_byte_data(client, page,
459 pmbus_fan_config_registers[id]);
463 have_rpm = !!(config & pmbus_fan_rpm_mask[id]);
464 if (want_rpm == have_rpm)
465 return pmbus_read_word_data(client, page, 0xff,
466 pmbus_fan_command_registers[id]);
468 /* Can't sensibly map between RPM and PWM, just return zero */
472 int pmbus_get_fan_rate_device(struct i2c_client *client, int page, int id,
473 enum pmbus_fan_mode mode)
475 return pmbus_get_fan_rate(client, page, id, mode, false);
477 EXPORT_SYMBOL_NS_GPL(pmbus_get_fan_rate_device, PMBUS);
479 int pmbus_get_fan_rate_cached(struct i2c_client *client, int page, int id,
480 enum pmbus_fan_mode mode)
482 return pmbus_get_fan_rate(client, page, id, mode, true);
484 EXPORT_SYMBOL_NS_GPL(pmbus_get_fan_rate_cached, PMBUS);
486 static void pmbus_clear_fault_page(struct i2c_client *client, int page)
488 _pmbus_write_byte(client, page, PMBUS_CLEAR_FAULTS);
491 void pmbus_clear_faults(struct i2c_client *client)
493 struct pmbus_data *data = i2c_get_clientdata(client);
496 for (i = 0; i < data->info->pages; i++)
497 pmbus_clear_fault_page(client, i);
499 EXPORT_SYMBOL_NS_GPL(pmbus_clear_faults, PMBUS);
501 static int pmbus_check_status_cml(struct i2c_client *client)
503 struct pmbus_data *data = i2c_get_clientdata(client);
506 status = data->read_status(client, -1);
507 if (status < 0 || (status & PB_STATUS_CML)) {
508 status2 = _pmbus_read_byte_data(client, -1, PMBUS_STATUS_CML);
509 if (status2 < 0 || (status2 & PB_CML_FAULT_INVALID_COMMAND))
515 static bool pmbus_check_register(struct i2c_client *client,
516 int (*func)(struct i2c_client *client,
521 struct pmbus_data *data = i2c_get_clientdata(client);
523 rv = func(client, page, reg);
524 if (rv >= 0 && !(data->flags & PMBUS_SKIP_STATUS_CHECK))
525 rv = pmbus_check_status_cml(client);
526 if (rv < 0 && (data->flags & PMBUS_READ_STATUS_AFTER_FAILED_CHECK))
527 data->read_status(client, -1);
528 pmbus_clear_fault_page(client, -1);
532 static bool pmbus_check_status_register(struct i2c_client *client, int page)
535 struct pmbus_data *data = i2c_get_clientdata(client);
537 status = data->read_status(client, page);
538 if (status >= 0 && !(data->flags & PMBUS_SKIP_STATUS_CHECK) &&
539 (status & PB_STATUS_CML)) {
540 status = _pmbus_read_byte_data(client, -1, PMBUS_STATUS_CML);
541 if (status < 0 || (status & PB_CML_FAULT_INVALID_COMMAND))
545 pmbus_clear_fault_page(client, -1);
549 bool pmbus_check_byte_register(struct i2c_client *client, int page, int reg)
551 return pmbus_check_register(client, _pmbus_read_byte_data, page, reg);
553 EXPORT_SYMBOL_NS_GPL(pmbus_check_byte_register, PMBUS);
555 bool pmbus_check_word_register(struct i2c_client *client, int page, int reg)
557 return pmbus_check_register(client, __pmbus_read_word_data, page, reg);
559 EXPORT_SYMBOL_NS_GPL(pmbus_check_word_register, PMBUS);
561 const struct pmbus_driver_info *pmbus_get_driver_info(struct i2c_client *client)
563 struct pmbus_data *data = i2c_get_clientdata(client);
567 EXPORT_SYMBOL_NS_GPL(pmbus_get_driver_info, PMBUS);
569 static int pmbus_get_status(struct i2c_client *client, int page, int reg)
571 struct pmbus_data *data = i2c_get_clientdata(client);
575 case PMBUS_STATUS_WORD:
576 status = data->read_status(client, page);
579 status = _pmbus_read_byte_data(client, page, reg);
583 pmbus_clear_faults(client);
587 static void pmbus_update_sensor_data(struct i2c_client *client, struct pmbus_sensor *sensor)
589 if (sensor->data < 0 || sensor->update)
590 sensor->data = _pmbus_read_word_data(client, sensor->page,
591 sensor->phase, sensor->reg);
595 * Convert linear sensor values to milli- or micro-units
596 * depending on sensor type.
598 static s64 pmbus_reg2data_linear(struct pmbus_data *data,
599 struct pmbus_sensor *sensor)
605 if (sensor->class == PSC_VOLTAGE_OUT) { /* LINEAR16 */
606 exponent = data->exponent[sensor->page];
607 mantissa = (u16) sensor->data;
608 } else { /* LINEAR11 */
609 exponent = ((s16)sensor->data) >> 11;
610 mantissa = ((s16)((sensor->data & 0x7ff) << 5)) >> 5;
615 /* scale result to milli-units for all sensors except fans */
616 if (sensor->class != PSC_FAN)
619 /* scale result to micro-units for power sensors */
620 if (sensor->class == PSC_POWER)
632 * Convert direct sensor values to milli- or micro-units
633 * depending on sensor type.
635 static s64 pmbus_reg2data_direct(struct pmbus_data *data,
636 struct pmbus_sensor *sensor)
638 s64 b, val = (s16)sensor->data;
641 m = data->info->m[sensor->class];
642 b = data->info->b[sensor->class];
643 R = data->info->R[sensor->class];
648 /* X = 1/m * (Y * 10^-R - b) */
650 /* scale result to milli-units for everything but fans */
651 if (!(sensor->class == PSC_FAN || sensor->class == PSC_PWM)) {
656 /* scale result to micro-units for power sensors */
657 if (sensor->class == PSC_POWER) {
667 val = div_s64(val + 5LL, 10L); /* round closest */
671 val = div_s64(val - b, m);
676 * Convert VID sensor values to milli- or micro-units
677 * depending on sensor type.
679 static s64 pmbus_reg2data_vid(struct pmbus_data *data,
680 struct pmbus_sensor *sensor)
682 long val = sensor->data;
685 switch (data->info->vrm_version[sensor->page]) {
687 if (val >= 0x02 && val <= 0xb2)
688 rv = DIV_ROUND_CLOSEST(160000 - (val - 2) * 625, 100);
692 rv = 250 + (val - 1) * 5;
696 rv = 500 + (val - 1) * 10;
700 rv = 200 + (val - 1) * 10;
703 if (val >= 0x0 && val <= 0xd8)
704 rv = DIV_ROUND_CLOSEST(155000 - val * 625, 100);
710 static s64 pmbus_reg2data(struct pmbus_data *data, struct pmbus_sensor *sensor)
714 if (!sensor->convert)
717 switch (data->info->format[sensor->class]) {
719 val = pmbus_reg2data_direct(data, sensor);
722 val = pmbus_reg2data_vid(data, sensor);
726 val = pmbus_reg2data_linear(data, sensor);
732 #define MAX_MANTISSA (1023 * 1000)
733 #define MIN_MANTISSA (511 * 1000)
735 static u16 pmbus_data2reg_linear(struct pmbus_data *data,
736 struct pmbus_sensor *sensor, s64 val)
738 s16 exponent = 0, mantissa;
739 bool negative = false;
745 if (sensor->class == PSC_VOLTAGE_OUT) {
746 /* LINEAR16 does not support negative voltages */
751 * For a static exponents, we don't have a choice
752 * but to adjust the value to it.
754 if (data->exponent[sensor->page] < 0)
755 val <<= -data->exponent[sensor->page];
757 val >>= data->exponent[sensor->page];
758 val = DIV_ROUND_CLOSEST_ULL(val, 1000);
759 return clamp_val(val, 0, 0xffff);
767 /* Power is in uW. Convert to mW before converting. */
768 if (sensor->class == PSC_POWER)
769 val = DIV_ROUND_CLOSEST_ULL(val, 1000);
772 * For simplicity, convert fan data to milli-units
773 * before calculating the exponent.
775 if (sensor->class == PSC_FAN)
778 /* Reduce large mantissa until it fits into 10 bit */
779 while (val >= MAX_MANTISSA && exponent < 15) {
783 /* Increase small mantissa to improve precision */
784 while (val < MIN_MANTISSA && exponent > -15) {
789 /* Convert mantissa from milli-units to units */
790 mantissa = clamp_val(DIV_ROUND_CLOSEST_ULL(val, 1000), 0, 0x3ff);
794 mantissa = -mantissa;
796 /* Convert to 5 bit exponent, 11 bit mantissa */
797 return (mantissa & 0x7ff) | ((exponent << 11) & 0xf800);
800 static u16 pmbus_data2reg_direct(struct pmbus_data *data,
801 struct pmbus_sensor *sensor, s64 val)
806 m = data->info->m[sensor->class];
807 b = data->info->b[sensor->class];
808 R = data->info->R[sensor->class];
810 /* Power is in uW. Adjust R and b. */
811 if (sensor->class == PSC_POWER) {
816 /* Calculate Y = (m * X + b) * 10^R */
817 if (!(sensor->class == PSC_FAN || sensor->class == PSC_PWM)) {
818 R -= 3; /* Adjust R and b for data in milli-units */
828 val = div_s64(val + 5LL, 10L); /* round closest */
832 return (u16)clamp_val(val, S16_MIN, S16_MAX);
835 static u16 pmbus_data2reg_vid(struct pmbus_data *data,
836 struct pmbus_sensor *sensor, s64 val)
838 val = clamp_val(val, 500, 1600);
840 return 2 + DIV_ROUND_CLOSEST_ULL((1600LL - val) * 100LL, 625);
843 static u16 pmbus_data2reg(struct pmbus_data *data,
844 struct pmbus_sensor *sensor, s64 val)
848 if (!sensor->convert)
851 switch (data->info->format[sensor->class]) {
853 regval = pmbus_data2reg_direct(data, sensor, val);
856 regval = pmbus_data2reg_vid(data, sensor, val);
860 regval = pmbus_data2reg_linear(data, sensor, val);
867 * Return boolean calculated from converted data.
868 * <index> defines a status register index and mask.
869 * The mask is in the lower 8 bits, the register index is in bits 8..23.
871 * The associated pmbus_boolean structure contains optional pointers to two
872 * sensor attributes. If specified, those attributes are compared against each
873 * other to determine if a limit has been exceeded.
875 * If the sensor attribute pointers are NULL, the function returns true if
876 * (status[reg] & mask) is true.
878 * If sensor attribute pointers are provided, a comparison against a specified
879 * limit has to be performed to determine the boolean result.
880 * In this case, the function returns true if v1 >= v2 (where v1 and v2 are
881 * sensor values referenced by sensor attribute pointers s1 and s2).
883 * To determine if an object exceeds upper limits, specify <s1,s2> = <v,limit>.
884 * To determine if an object exceeds lower limits, specify <s1,s2> = <limit,v>.
886 * If a negative value is stored in any of the referenced registers, this value
887 * reflects an error code which will be returned.
889 static int pmbus_get_boolean(struct i2c_client *client, struct pmbus_boolean *b,
892 struct pmbus_data *data = i2c_get_clientdata(client);
893 struct pmbus_sensor *s1 = b->s1;
894 struct pmbus_sensor *s2 = b->s2;
895 u16 mask = pb_index_to_mask(index);
896 u8 page = pb_index_to_page(index);
897 u16 reg = pb_index_to_reg(index);
901 mutex_lock(&data->update_lock);
902 status = pmbus_get_status(client, page, reg);
909 pmbus_update_sensor_data(client, s1);
911 pmbus_update_sensor_data(client, s2);
913 regval = status & mask;
915 ret = pmbus_write_byte_data(client, page, reg, regval);
931 v1 = pmbus_reg2data(data, s1);
932 v2 = pmbus_reg2data(data, s2);
933 ret = !!(regval && v1 >= v2);
938 mutex_unlock(&data->update_lock);
942 static ssize_t pmbus_show_boolean(struct device *dev,
943 struct device_attribute *da, char *buf)
945 struct sensor_device_attribute *attr = to_sensor_dev_attr(da);
946 struct pmbus_boolean *boolean = to_pmbus_boolean(attr);
947 struct i2c_client *client = to_i2c_client(dev->parent);
950 val = pmbus_get_boolean(client, boolean, attr->index);
953 return sysfs_emit(buf, "%d\n", val);
956 static ssize_t pmbus_show_sensor(struct device *dev,
957 struct device_attribute *devattr, char *buf)
959 struct i2c_client *client = to_i2c_client(dev->parent);
960 struct pmbus_sensor *sensor = to_pmbus_sensor(devattr);
961 struct pmbus_data *data = i2c_get_clientdata(client);
964 mutex_lock(&data->update_lock);
965 pmbus_update_sensor_data(client, sensor);
966 if (sensor->data < 0)
969 ret = sysfs_emit(buf, "%lld\n", pmbus_reg2data(data, sensor));
970 mutex_unlock(&data->update_lock);
974 static ssize_t pmbus_set_sensor(struct device *dev,
975 struct device_attribute *devattr,
976 const char *buf, size_t count)
978 struct i2c_client *client = to_i2c_client(dev->parent);
979 struct pmbus_data *data = i2c_get_clientdata(client);
980 struct pmbus_sensor *sensor = to_pmbus_sensor(devattr);
986 if (kstrtos64(buf, 10, &val) < 0)
989 mutex_lock(&data->update_lock);
990 regval = pmbus_data2reg(data, sensor, val);
991 ret = _pmbus_write_word_data(client, sensor->page, sensor->reg, regval);
995 sensor->data = -ENODATA;
996 mutex_unlock(&data->update_lock);
1000 static ssize_t pmbus_show_label(struct device *dev,
1001 struct device_attribute *da, char *buf)
1003 struct pmbus_label *label = to_pmbus_label(da);
1005 return sysfs_emit(buf, "%s\n", label->label);
1008 static int pmbus_add_attribute(struct pmbus_data *data, struct attribute *attr)
1010 if (data->num_attributes >= data->max_attributes - 1) {
1011 int new_max_attrs = data->max_attributes + PMBUS_ATTR_ALLOC_SIZE;
1012 void *new_attrs = devm_krealloc(data->dev, data->group.attrs,
1013 new_max_attrs * sizeof(void *),
1017 data->group.attrs = new_attrs;
1018 data->max_attributes = new_max_attrs;
1021 data->group.attrs[data->num_attributes++] = attr;
1022 data->group.attrs[data->num_attributes] = NULL;
1026 static void pmbus_dev_attr_init(struct device_attribute *dev_attr,
1029 ssize_t (*show)(struct device *dev,
1030 struct device_attribute *attr,
1032 ssize_t (*store)(struct device *dev,
1033 struct device_attribute *attr,
1034 const char *buf, size_t count))
1036 sysfs_attr_init(&dev_attr->attr);
1037 dev_attr->attr.name = name;
1038 dev_attr->attr.mode = mode;
1039 dev_attr->show = show;
1040 dev_attr->store = store;
1043 static void pmbus_attr_init(struct sensor_device_attribute *a,
1046 ssize_t (*show)(struct device *dev,
1047 struct device_attribute *attr,
1049 ssize_t (*store)(struct device *dev,
1050 struct device_attribute *attr,
1051 const char *buf, size_t count),
1054 pmbus_dev_attr_init(&a->dev_attr, name, mode, show, store);
1058 static int pmbus_add_boolean(struct pmbus_data *data,
1059 const char *name, const char *type, int seq,
1060 struct pmbus_sensor *s1,
1061 struct pmbus_sensor *s2,
1062 u8 page, u16 reg, u16 mask)
1064 struct pmbus_boolean *boolean;
1065 struct sensor_device_attribute *a;
1067 if (WARN((s1 && !s2) || (!s1 && s2), "Bad s1/s2 parameters\n"))
1070 boolean = devm_kzalloc(data->dev, sizeof(*boolean), GFP_KERNEL);
1074 a = &boolean->attribute;
1076 snprintf(boolean->name, sizeof(boolean->name), "%s%d_%s",
1080 pmbus_attr_init(a, boolean->name, 0444, pmbus_show_boolean, NULL,
1081 pb_reg_to_index(page, reg, mask));
1083 return pmbus_add_attribute(data, &a->dev_attr.attr);
1086 static struct pmbus_sensor *pmbus_add_sensor(struct pmbus_data *data,
1087 const char *name, const char *type,
1088 int seq, int page, int phase,
1090 enum pmbus_sensor_classes class,
1091 bool update, bool readonly,
1094 struct pmbus_sensor *sensor;
1095 struct device_attribute *a;
1097 sensor = devm_kzalloc(data->dev, sizeof(*sensor), GFP_KERNEL);
1100 a = &sensor->attribute;
1103 snprintf(sensor->name, sizeof(sensor->name), "%s%d_%s",
1106 snprintf(sensor->name, sizeof(sensor->name), "%s%d",
1109 if (data->flags & PMBUS_WRITE_PROTECTED)
1112 sensor->page = page;
1113 sensor->phase = phase;
1115 sensor->class = class;
1116 sensor->update = update;
1117 sensor->convert = convert;
1118 sensor->data = -ENODATA;
1119 pmbus_dev_attr_init(a, sensor->name,
1120 readonly ? 0444 : 0644,
1121 pmbus_show_sensor, pmbus_set_sensor);
1123 if (pmbus_add_attribute(data, &a->attr))
1126 sensor->next = data->sensors;
1127 data->sensors = sensor;
1132 static int pmbus_add_label(struct pmbus_data *data,
1133 const char *name, int seq,
1134 const char *lstring, int index, int phase)
1136 struct pmbus_label *label;
1137 struct device_attribute *a;
1139 label = devm_kzalloc(data->dev, sizeof(*label), GFP_KERNEL);
1143 a = &label->attribute;
1145 snprintf(label->name, sizeof(label->name), "%s%d_label", name, seq);
1148 strncpy(label->label, lstring,
1149 sizeof(label->label) - 1);
1151 snprintf(label->label, sizeof(label->label), "%s.%d",
1155 snprintf(label->label, sizeof(label->label), "%s%d",
1158 snprintf(label->label, sizeof(label->label), "%s%d.%d",
1159 lstring, index, phase);
1162 pmbus_dev_attr_init(a, label->name, 0444, pmbus_show_label, NULL);
1163 return pmbus_add_attribute(data, &a->attr);
1167 * Search for attributes. Allocate sensors, booleans, and labels as needed.
1171 * The pmbus_limit_attr structure describes a single limit attribute
1172 * and its associated alarm attribute.
1174 struct pmbus_limit_attr {
1175 u16 reg; /* Limit register */
1176 u16 sbit; /* Alarm attribute status bit */
1177 bool update; /* True if register needs updates */
1178 bool low; /* True if low limit; for limits with compare
1180 const char *attr; /* Attribute name */
1181 const char *alarm; /* Alarm attribute name */
1185 * The pmbus_sensor_attr structure describes one sensor attribute. This
1186 * description includes a reference to the associated limit attributes.
1188 struct pmbus_sensor_attr {
1189 u16 reg; /* sensor register */
1190 u16 gbit; /* generic status bit */
1191 u8 nlimit; /* # of limit registers */
1192 enum pmbus_sensor_classes class;/* sensor class */
1193 const char *label; /* sensor label */
1194 bool paged; /* true if paged sensor */
1195 bool update; /* true if update needed */
1196 bool compare; /* true if compare function needed */
1197 u32 func; /* sensor mask */
1198 u32 sfunc; /* sensor status mask */
1199 int sreg; /* status register */
1200 const struct pmbus_limit_attr *limit;/* limit registers */
1204 * Add a set of limit attributes and, if supported, the associated
1206 * returns 0 if no alarm register found, 1 if an alarm register was found,
1209 static int pmbus_add_limit_attrs(struct i2c_client *client,
1210 struct pmbus_data *data,
1211 const struct pmbus_driver_info *info,
1212 const char *name, int index, int page,
1213 struct pmbus_sensor *base,
1214 const struct pmbus_sensor_attr *attr)
1216 const struct pmbus_limit_attr *l = attr->limit;
1217 int nlimit = attr->nlimit;
1220 struct pmbus_sensor *curr;
1222 for (i = 0; i < nlimit; i++) {
1223 if (pmbus_check_word_register(client, page, l->reg)) {
1224 curr = pmbus_add_sensor(data, name, l->attr, index,
1225 page, 0xff, l->reg, attr->class,
1226 attr->update || l->update,
1230 if (l->sbit && (info->func[page] & attr->sfunc)) {
1231 ret = pmbus_add_boolean(data, name,
1233 attr->compare ? l->low ? curr : base
1235 attr->compare ? l->low ? base : curr
1237 page, attr->sreg, l->sbit);
1248 static int pmbus_add_sensor_attrs_one(struct i2c_client *client,
1249 struct pmbus_data *data,
1250 const struct pmbus_driver_info *info,
1252 int index, int page, int phase,
1253 const struct pmbus_sensor_attr *attr,
1256 struct pmbus_sensor *base;
1257 bool upper = !!(attr->gbit & 0xff00); /* need to check STATUS_WORD */
1261 ret = pmbus_add_label(data, name, index, attr->label,
1262 paged ? page + 1 : 0, phase);
1266 base = pmbus_add_sensor(data, name, "input", index, page, phase,
1267 attr->reg, attr->class, true, true, true);
1270 /* No limit and alarm attributes for phase specific sensors */
1271 if (attr->sfunc && phase == 0xff) {
1272 ret = pmbus_add_limit_attrs(client, data, info, name,
1273 index, page, base, attr);
1277 * Add generic alarm attribute only if there are no individual
1278 * alarm attributes, if there is a global alarm bit, and if
1279 * the generic status register (word or byte, depending on
1280 * which global bit is set) for this page is accessible.
1282 if (!ret && attr->gbit &&
1283 (!upper || data->has_status_word) &&
1284 pmbus_check_status_register(client, page)) {
1285 ret = pmbus_add_boolean(data, name, "alarm", index,
1287 page, PMBUS_STATUS_WORD,
1296 static bool pmbus_sensor_is_paged(const struct pmbus_driver_info *info,
1297 const struct pmbus_sensor_attr *attr)
1305 * Some attributes may be present on more than one page despite
1306 * not being marked with the paged attribute. If that is the case,
1307 * then treat the sensor as being paged and add the page suffix to the
1309 * We don't just add the paged attribute to all such attributes, in
1310 * order to maintain the un-suffixed labels in the case where the
1311 * attribute is only on page 0.
1313 for (p = 1; p < info->pages; p++) {
1314 if (info->func[p] & attr->func)
1320 static int pmbus_add_sensor_attrs(struct i2c_client *client,
1321 struct pmbus_data *data,
1323 const struct pmbus_sensor_attr *attrs,
1326 const struct pmbus_driver_info *info = data->info;
1331 for (i = 0; i < nattrs; i++) {
1333 bool paged = pmbus_sensor_is_paged(info, attrs);
1335 pages = paged ? info->pages : 1;
1336 for (page = 0; page < pages; page++) {
1337 if (info->func[page] & attrs->func) {
1338 ret = pmbus_add_sensor_attrs_one(client, data, info,
1340 0xff, attrs, paged);
1345 if (info->phases[page]) {
1348 for (phase = 0; phase < info->phases[page];
1350 if (!(info->pfunc[phase] & attrs->func))
1352 ret = pmbus_add_sensor_attrs_one(client,
1353 data, info, name, index, page,
1354 phase, attrs, paged);
1366 static const struct pmbus_limit_attr vin_limit_attrs[] = {
1368 .reg = PMBUS_VIN_UV_WARN_LIMIT,
1370 .alarm = "min_alarm",
1371 .sbit = PB_VOLTAGE_UV_WARNING,
1373 .reg = PMBUS_VIN_UV_FAULT_LIMIT,
1375 .alarm = "lcrit_alarm",
1376 .sbit = PB_VOLTAGE_UV_FAULT | PB_VOLTAGE_VIN_OFF,
1378 .reg = PMBUS_VIN_OV_WARN_LIMIT,
1380 .alarm = "max_alarm",
1381 .sbit = PB_VOLTAGE_OV_WARNING,
1383 .reg = PMBUS_VIN_OV_FAULT_LIMIT,
1385 .alarm = "crit_alarm",
1386 .sbit = PB_VOLTAGE_OV_FAULT,
1388 .reg = PMBUS_VIRT_READ_VIN_AVG,
1392 .reg = PMBUS_VIRT_READ_VIN_MIN,
1396 .reg = PMBUS_VIRT_READ_VIN_MAX,
1400 .reg = PMBUS_VIRT_RESET_VIN_HISTORY,
1401 .attr = "reset_history",
1403 .reg = PMBUS_MFR_VIN_MIN,
1404 .attr = "rated_min",
1406 .reg = PMBUS_MFR_VIN_MAX,
1407 .attr = "rated_max",
1411 static const struct pmbus_limit_attr vmon_limit_attrs[] = {
1413 .reg = PMBUS_VIRT_VMON_UV_WARN_LIMIT,
1415 .alarm = "min_alarm",
1416 .sbit = PB_VOLTAGE_UV_WARNING,
1418 .reg = PMBUS_VIRT_VMON_UV_FAULT_LIMIT,
1420 .alarm = "lcrit_alarm",
1421 .sbit = PB_VOLTAGE_UV_FAULT,
1423 .reg = PMBUS_VIRT_VMON_OV_WARN_LIMIT,
1425 .alarm = "max_alarm",
1426 .sbit = PB_VOLTAGE_OV_WARNING,
1428 .reg = PMBUS_VIRT_VMON_OV_FAULT_LIMIT,
1430 .alarm = "crit_alarm",
1431 .sbit = PB_VOLTAGE_OV_FAULT,
1435 static const struct pmbus_limit_attr vout_limit_attrs[] = {
1437 .reg = PMBUS_VOUT_UV_WARN_LIMIT,
1439 .alarm = "min_alarm",
1440 .sbit = PB_VOLTAGE_UV_WARNING,
1442 .reg = PMBUS_VOUT_UV_FAULT_LIMIT,
1444 .alarm = "lcrit_alarm",
1445 .sbit = PB_VOLTAGE_UV_FAULT,
1447 .reg = PMBUS_VOUT_OV_WARN_LIMIT,
1449 .alarm = "max_alarm",
1450 .sbit = PB_VOLTAGE_OV_WARNING,
1452 .reg = PMBUS_VOUT_OV_FAULT_LIMIT,
1454 .alarm = "crit_alarm",
1455 .sbit = PB_VOLTAGE_OV_FAULT,
1457 .reg = PMBUS_VIRT_READ_VOUT_AVG,
1461 .reg = PMBUS_VIRT_READ_VOUT_MIN,
1465 .reg = PMBUS_VIRT_READ_VOUT_MAX,
1469 .reg = PMBUS_VIRT_RESET_VOUT_HISTORY,
1470 .attr = "reset_history",
1472 .reg = PMBUS_MFR_VOUT_MIN,
1473 .attr = "rated_min",
1475 .reg = PMBUS_MFR_VOUT_MAX,
1476 .attr = "rated_max",
1480 static const struct pmbus_sensor_attr voltage_attributes[] = {
1482 .reg = PMBUS_READ_VIN,
1483 .class = PSC_VOLTAGE_IN,
1485 .func = PMBUS_HAVE_VIN,
1486 .sfunc = PMBUS_HAVE_STATUS_INPUT,
1487 .sreg = PMBUS_STATUS_INPUT,
1488 .gbit = PB_STATUS_VIN_UV,
1489 .limit = vin_limit_attrs,
1490 .nlimit = ARRAY_SIZE(vin_limit_attrs),
1492 .reg = PMBUS_VIRT_READ_VMON,
1493 .class = PSC_VOLTAGE_IN,
1495 .func = PMBUS_HAVE_VMON,
1496 .sfunc = PMBUS_HAVE_STATUS_VMON,
1497 .sreg = PMBUS_VIRT_STATUS_VMON,
1498 .limit = vmon_limit_attrs,
1499 .nlimit = ARRAY_SIZE(vmon_limit_attrs),
1501 .reg = PMBUS_READ_VCAP,
1502 .class = PSC_VOLTAGE_IN,
1504 .func = PMBUS_HAVE_VCAP,
1506 .reg = PMBUS_READ_VOUT,
1507 .class = PSC_VOLTAGE_OUT,
1510 .func = PMBUS_HAVE_VOUT,
1511 .sfunc = PMBUS_HAVE_STATUS_VOUT,
1512 .sreg = PMBUS_STATUS_VOUT,
1513 .gbit = PB_STATUS_VOUT_OV,
1514 .limit = vout_limit_attrs,
1515 .nlimit = ARRAY_SIZE(vout_limit_attrs),
1519 /* Current attributes */
1521 static const struct pmbus_limit_attr iin_limit_attrs[] = {
1523 .reg = PMBUS_IIN_OC_WARN_LIMIT,
1525 .alarm = "max_alarm",
1526 .sbit = PB_IIN_OC_WARNING,
1528 .reg = PMBUS_IIN_OC_FAULT_LIMIT,
1530 .alarm = "crit_alarm",
1531 .sbit = PB_IIN_OC_FAULT,
1533 .reg = PMBUS_VIRT_READ_IIN_AVG,
1537 .reg = PMBUS_VIRT_READ_IIN_MIN,
1541 .reg = PMBUS_VIRT_READ_IIN_MAX,
1545 .reg = PMBUS_VIRT_RESET_IIN_HISTORY,
1546 .attr = "reset_history",
1548 .reg = PMBUS_MFR_IIN_MAX,
1549 .attr = "rated_max",
1553 static const struct pmbus_limit_attr iout_limit_attrs[] = {
1555 .reg = PMBUS_IOUT_OC_WARN_LIMIT,
1557 .alarm = "max_alarm",
1558 .sbit = PB_IOUT_OC_WARNING,
1560 .reg = PMBUS_IOUT_UC_FAULT_LIMIT,
1562 .alarm = "lcrit_alarm",
1563 .sbit = PB_IOUT_UC_FAULT,
1565 .reg = PMBUS_IOUT_OC_FAULT_LIMIT,
1567 .alarm = "crit_alarm",
1568 .sbit = PB_IOUT_OC_FAULT,
1570 .reg = PMBUS_VIRT_READ_IOUT_AVG,
1574 .reg = PMBUS_VIRT_READ_IOUT_MIN,
1578 .reg = PMBUS_VIRT_READ_IOUT_MAX,
1582 .reg = PMBUS_VIRT_RESET_IOUT_HISTORY,
1583 .attr = "reset_history",
1585 .reg = PMBUS_MFR_IOUT_MAX,
1586 .attr = "rated_max",
1590 static const struct pmbus_sensor_attr current_attributes[] = {
1592 .reg = PMBUS_READ_IIN,
1593 .class = PSC_CURRENT_IN,
1595 .func = PMBUS_HAVE_IIN,
1596 .sfunc = PMBUS_HAVE_STATUS_INPUT,
1597 .sreg = PMBUS_STATUS_INPUT,
1598 .gbit = PB_STATUS_INPUT,
1599 .limit = iin_limit_attrs,
1600 .nlimit = ARRAY_SIZE(iin_limit_attrs),
1602 .reg = PMBUS_READ_IOUT,
1603 .class = PSC_CURRENT_OUT,
1606 .func = PMBUS_HAVE_IOUT,
1607 .sfunc = PMBUS_HAVE_STATUS_IOUT,
1608 .sreg = PMBUS_STATUS_IOUT,
1609 .gbit = PB_STATUS_IOUT_OC,
1610 .limit = iout_limit_attrs,
1611 .nlimit = ARRAY_SIZE(iout_limit_attrs),
1615 /* Power attributes */
1617 static const struct pmbus_limit_attr pin_limit_attrs[] = {
1619 .reg = PMBUS_PIN_OP_WARN_LIMIT,
1622 .sbit = PB_PIN_OP_WARNING,
1624 .reg = PMBUS_VIRT_READ_PIN_AVG,
1628 .reg = PMBUS_VIRT_READ_PIN_MIN,
1630 .attr = "input_lowest",
1632 .reg = PMBUS_VIRT_READ_PIN_MAX,
1634 .attr = "input_highest",
1636 .reg = PMBUS_VIRT_RESET_PIN_HISTORY,
1637 .attr = "reset_history",
1639 .reg = PMBUS_MFR_PIN_MAX,
1640 .attr = "rated_max",
1644 static const struct pmbus_limit_attr pout_limit_attrs[] = {
1646 .reg = PMBUS_POUT_MAX,
1648 .alarm = "cap_alarm",
1649 .sbit = PB_POWER_LIMITING,
1651 .reg = PMBUS_POUT_OP_WARN_LIMIT,
1653 .alarm = "max_alarm",
1654 .sbit = PB_POUT_OP_WARNING,
1656 .reg = PMBUS_POUT_OP_FAULT_LIMIT,
1658 .alarm = "crit_alarm",
1659 .sbit = PB_POUT_OP_FAULT,
1661 .reg = PMBUS_VIRT_READ_POUT_AVG,
1665 .reg = PMBUS_VIRT_READ_POUT_MIN,
1667 .attr = "input_lowest",
1669 .reg = PMBUS_VIRT_READ_POUT_MAX,
1671 .attr = "input_highest",
1673 .reg = PMBUS_VIRT_RESET_POUT_HISTORY,
1674 .attr = "reset_history",
1676 .reg = PMBUS_MFR_POUT_MAX,
1677 .attr = "rated_max",
1681 static const struct pmbus_sensor_attr power_attributes[] = {
1683 .reg = PMBUS_READ_PIN,
1686 .func = PMBUS_HAVE_PIN,
1687 .sfunc = PMBUS_HAVE_STATUS_INPUT,
1688 .sreg = PMBUS_STATUS_INPUT,
1689 .gbit = PB_STATUS_INPUT,
1690 .limit = pin_limit_attrs,
1691 .nlimit = ARRAY_SIZE(pin_limit_attrs),
1693 .reg = PMBUS_READ_POUT,
1697 .func = PMBUS_HAVE_POUT,
1698 .sfunc = PMBUS_HAVE_STATUS_IOUT,
1699 .sreg = PMBUS_STATUS_IOUT,
1700 .limit = pout_limit_attrs,
1701 .nlimit = ARRAY_SIZE(pout_limit_attrs),
1705 /* Temperature atributes */
1707 static const struct pmbus_limit_attr temp_limit_attrs[] = {
1709 .reg = PMBUS_UT_WARN_LIMIT,
1712 .alarm = "min_alarm",
1713 .sbit = PB_TEMP_UT_WARNING,
1715 .reg = PMBUS_UT_FAULT_LIMIT,
1718 .alarm = "lcrit_alarm",
1719 .sbit = PB_TEMP_UT_FAULT,
1721 .reg = PMBUS_OT_WARN_LIMIT,
1723 .alarm = "max_alarm",
1724 .sbit = PB_TEMP_OT_WARNING,
1726 .reg = PMBUS_OT_FAULT_LIMIT,
1728 .alarm = "crit_alarm",
1729 .sbit = PB_TEMP_OT_FAULT,
1731 .reg = PMBUS_VIRT_READ_TEMP_MIN,
1734 .reg = PMBUS_VIRT_READ_TEMP_AVG,
1737 .reg = PMBUS_VIRT_READ_TEMP_MAX,
1740 .reg = PMBUS_VIRT_RESET_TEMP_HISTORY,
1741 .attr = "reset_history",
1743 .reg = PMBUS_MFR_MAX_TEMP_1,
1744 .attr = "rated_max",
1748 static const struct pmbus_limit_attr temp_limit_attrs2[] = {
1750 .reg = PMBUS_UT_WARN_LIMIT,
1753 .alarm = "min_alarm",
1754 .sbit = PB_TEMP_UT_WARNING,
1756 .reg = PMBUS_UT_FAULT_LIMIT,
1759 .alarm = "lcrit_alarm",
1760 .sbit = PB_TEMP_UT_FAULT,
1762 .reg = PMBUS_OT_WARN_LIMIT,
1764 .alarm = "max_alarm",
1765 .sbit = PB_TEMP_OT_WARNING,
1767 .reg = PMBUS_OT_FAULT_LIMIT,
1769 .alarm = "crit_alarm",
1770 .sbit = PB_TEMP_OT_FAULT,
1772 .reg = PMBUS_VIRT_READ_TEMP2_MIN,
1775 .reg = PMBUS_VIRT_READ_TEMP2_AVG,
1778 .reg = PMBUS_VIRT_READ_TEMP2_MAX,
1781 .reg = PMBUS_VIRT_RESET_TEMP2_HISTORY,
1782 .attr = "reset_history",
1784 .reg = PMBUS_MFR_MAX_TEMP_2,
1785 .attr = "rated_max",
1789 static const struct pmbus_limit_attr temp_limit_attrs3[] = {
1791 .reg = PMBUS_UT_WARN_LIMIT,
1794 .alarm = "min_alarm",
1795 .sbit = PB_TEMP_UT_WARNING,
1797 .reg = PMBUS_UT_FAULT_LIMIT,
1800 .alarm = "lcrit_alarm",
1801 .sbit = PB_TEMP_UT_FAULT,
1803 .reg = PMBUS_OT_WARN_LIMIT,
1805 .alarm = "max_alarm",
1806 .sbit = PB_TEMP_OT_WARNING,
1808 .reg = PMBUS_OT_FAULT_LIMIT,
1810 .alarm = "crit_alarm",
1811 .sbit = PB_TEMP_OT_FAULT,
1813 .reg = PMBUS_MFR_MAX_TEMP_3,
1814 .attr = "rated_max",
1818 static const struct pmbus_sensor_attr temp_attributes[] = {
1820 .reg = PMBUS_READ_TEMPERATURE_1,
1821 .class = PSC_TEMPERATURE,
1825 .func = PMBUS_HAVE_TEMP,
1826 .sfunc = PMBUS_HAVE_STATUS_TEMP,
1827 .sreg = PMBUS_STATUS_TEMPERATURE,
1828 .gbit = PB_STATUS_TEMPERATURE,
1829 .limit = temp_limit_attrs,
1830 .nlimit = ARRAY_SIZE(temp_limit_attrs),
1832 .reg = PMBUS_READ_TEMPERATURE_2,
1833 .class = PSC_TEMPERATURE,
1837 .func = PMBUS_HAVE_TEMP2,
1838 .sfunc = PMBUS_HAVE_STATUS_TEMP,
1839 .sreg = PMBUS_STATUS_TEMPERATURE,
1840 .gbit = PB_STATUS_TEMPERATURE,
1841 .limit = temp_limit_attrs2,
1842 .nlimit = ARRAY_SIZE(temp_limit_attrs2),
1844 .reg = PMBUS_READ_TEMPERATURE_3,
1845 .class = PSC_TEMPERATURE,
1849 .func = PMBUS_HAVE_TEMP3,
1850 .sfunc = PMBUS_HAVE_STATUS_TEMP,
1851 .sreg = PMBUS_STATUS_TEMPERATURE,
1852 .gbit = PB_STATUS_TEMPERATURE,
1853 .limit = temp_limit_attrs3,
1854 .nlimit = ARRAY_SIZE(temp_limit_attrs3),
1858 static const int pmbus_fan_registers[] = {
1859 PMBUS_READ_FAN_SPEED_1,
1860 PMBUS_READ_FAN_SPEED_2,
1861 PMBUS_READ_FAN_SPEED_3,
1862 PMBUS_READ_FAN_SPEED_4
1865 static const int pmbus_fan_status_registers[] = {
1866 PMBUS_STATUS_FAN_12,
1867 PMBUS_STATUS_FAN_12,
1868 PMBUS_STATUS_FAN_34,
1872 static const u32 pmbus_fan_flags[] = {
1879 static const u32 pmbus_fan_status_flags[] = {
1880 PMBUS_HAVE_STATUS_FAN12,
1881 PMBUS_HAVE_STATUS_FAN12,
1882 PMBUS_HAVE_STATUS_FAN34,
1883 PMBUS_HAVE_STATUS_FAN34
1888 /* Precondition: FAN_CONFIG_x_y and FAN_COMMAND_x must exist for the fan ID */
1889 static int pmbus_add_fan_ctrl(struct i2c_client *client,
1890 struct pmbus_data *data, int index, int page, int id,
1893 struct pmbus_sensor *sensor;
1895 sensor = pmbus_add_sensor(data, "fan", "target", index, page,
1896 0xff, PMBUS_VIRT_FAN_TARGET_1 + id, PSC_FAN,
1897 false, false, true);
1902 if (!((data->info->func[page] & PMBUS_HAVE_PWM12) ||
1903 (data->info->func[page] & PMBUS_HAVE_PWM34)))
1906 sensor = pmbus_add_sensor(data, "pwm", NULL, index, page,
1907 0xff, PMBUS_VIRT_PWM_1 + id, PSC_PWM,
1908 false, false, true);
1913 sensor = pmbus_add_sensor(data, "pwm", "enable", index, page,
1914 0xff, PMBUS_VIRT_PWM_ENABLE_1 + id, PSC_PWM,
1915 true, false, false);
1923 static int pmbus_add_fan_attributes(struct i2c_client *client,
1924 struct pmbus_data *data)
1926 const struct pmbus_driver_info *info = data->info;
1931 for (page = 0; page < info->pages; page++) {
1934 for (f = 0; f < ARRAY_SIZE(pmbus_fan_registers); f++) {
1937 if (!(info->func[page] & pmbus_fan_flags[f]))
1940 if (!pmbus_check_word_register(client, page,
1941 pmbus_fan_registers[f]))
1945 * Skip fan if not installed.
1946 * Each fan configuration register covers multiple fans,
1947 * so we have to do some magic.
1949 regval = _pmbus_read_byte_data(client, page,
1950 pmbus_fan_config_registers[f]);
1952 (!(regval & (PB_FAN_1_INSTALLED >> ((f & 1) * 4)))))
1955 if (pmbus_add_sensor(data, "fan", "input", index,
1956 page, 0xff, pmbus_fan_registers[f],
1957 PSC_FAN, true, true, true) == NULL)
1961 if (pmbus_check_word_register(client, page,
1962 pmbus_fan_command_registers[f])) {
1963 ret = pmbus_add_fan_ctrl(client, data, index,
1970 * Each fan status register covers multiple fans,
1971 * so we have to do some magic.
1973 if ((info->func[page] & pmbus_fan_status_flags[f]) &&
1974 pmbus_check_byte_register(client,
1975 page, pmbus_fan_status_registers[f])) {
1978 if (f > 1) /* fan 3, 4 */
1979 reg = PMBUS_STATUS_FAN_34;
1981 reg = PMBUS_STATUS_FAN_12;
1982 ret = pmbus_add_boolean(data, "fan",
1983 "alarm", index, NULL, NULL, page, reg,
1984 PB_FAN_FAN1_WARNING >> (f & 1));
1987 ret = pmbus_add_boolean(data, "fan",
1988 "fault", index, NULL, NULL, page, reg,
1989 PB_FAN_FAN1_FAULT >> (f & 1));
1999 struct pmbus_samples_attr {
2004 struct pmbus_samples_reg {
2006 struct pmbus_samples_attr *attr;
2007 struct device_attribute dev_attr;
2010 static struct pmbus_samples_attr pmbus_samples_registers[] = {
2012 .reg = PMBUS_VIRT_SAMPLES,
2015 .reg = PMBUS_VIRT_IN_SAMPLES,
2016 .name = "in_samples",
2018 .reg = PMBUS_VIRT_CURR_SAMPLES,
2019 .name = "curr_samples",
2021 .reg = PMBUS_VIRT_POWER_SAMPLES,
2022 .name = "power_samples",
2024 .reg = PMBUS_VIRT_TEMP_SAMPLES,
2025 .name = "temp_samples",
2029 #define to_samples_reg(x) container_of(x, struct pmbus_samples_reg, dev_attr)
2031 static ssize_t pmbus_show_samples(struct device *dev,
2032 struct device_attribute *devattr, char *buf)
2035 struct i2c_client *client = to_i2c_client(dev->parent);
2036 struct pmbus_samples_reg *reg = to_samples_reg(devattr);
2037 struct pmbus_data *data = i2c_get_clientdata(client);
2039 mutex_lock(&data->update_lock);
2040 val = _pmbus_read_word_data(client, reg->page, 0xff, reg->attr->reg);
2041 mutex_unlock(&data->update_lock);
2045 return sysfs_emit(buf, "%d\n", val);
2048 static ssize_t pmbus_set_samples(struct device *dev,
2049 struct device_attribute *devattr,
2050 const char *buf, size_t count)
2054 struct i2c_client *client = to_i2c_client(dev->parent);
2055 struct pmbus_samples_reg *reg = to_samples_reg(devattr);
2056 struct pmbus_data *data = i2c_get_clientdata(client);
2058 if (kstrtol(buf, 0, &val) < 0)
2061 mutex_lock(&data->update_lock);
2062 ret = _pmbus_write_word_data(client, reg->page, reg->attr->reg, val);
2063 mutex_unlock(&data->update_lock);
2065 return ret ? : count;
2068 static int pmbus_add_samples_attr(struct pmbus_data *data, int page,
2069 struct pmbus_samples_attr *attr)
2071 struct pmbus_samples_reg *reg;
2073 reg = devm_kzalloc(data->dev, sizeof(*reg), GFP_KERNEL);
2080 pmbus_dev_attr_init(®->dev_attr, attr->name, 0644,
2081 pmbus_show_samples, pmbus_set_samples);
2083 return pmbus_add_attribute(data, ®->dev_attr.attr);
2086 static int pmbus_add_samples_attributes(struct i2c_client *client,
2087 struct pmbus_data *data)
2089 const struct pmbus_driver_info *info = data->info;
2092 if (!(info->func[0] & PMBUS_HAVE_SAMPLES))
2095 for (s = 0; s < ARRAY_SIZE(pmbus_samples_registers); s++) {
2096 struct pmbus_samples_attr *attr;
2099 attr = &pmbus_samples_registers[s];
2100 if (!pmbus_check_word_register(client, 0, attr->reg))
2103 ret = pmbus_add_samples_attr(data, 0, attr);
2111 static int pmbus_find_attributes(struct i2c_client *client,
2112 struct pmbus_data *data)
2116 /* Voltage sensors */
2117 ret = pmbus_add_sensor_attrs(client, data, "in", voltage_attributes,
2118 ARRAY_SIZE(voltage_attributes));
2122 /* Current sensors */
2123 ret = pmbus_add_sensor_attrs(client, data, "curr", current_attributes,
2124 ARRAY_SIZE(current_attributes));
2129 ret = pmbus_add_sensor_attrs(client, data, "power", power_attributes,
2130 ARRAY_SIZE(power_attributes));
2134 /* Temperature sensors */
2135 ret = pmbus_add_sensor_attrs(client, data, "temp", temp_attributes,
2136 ARRAY_SIZE(temp_attributes));
2141 ret = pmbus_add_fan_attributes(client, data);
2145 ret = pmbus_add_samples_attributes(client, data);
2150 * The pmbus_class_attr_map structure maps one sensor class to
2151 * it's corresponding sensor attributes array.
2153 struct pmbus_class_attr_map {
2154 enum pmbus_sensor_classes class;
2156 const struct pmbus_sensor_attr *attr;
2159 static const struct pmbus_class_attr_map class_attr_map[] = {
2161 .class = PSC_VOLTAGE_IN,
2162 .attr = voltage_attributes,
2163 .nattr = ARRAY_SIZE(voltage_attributes),
2165 .class = PSC_VOLTAGE_OUT,
2166 .attr = voltage_attributes,
2167 .nattr = ARRAY_SIZE(voltage_attributes),
2169 .class = PSC_CURRENT_IN,
2170 .attr = current_attributes,
2171 .nattr = ARRAY_SIZE(current_attributes),
2173 .class = PSC_CURRENT_OUT,
2174 .attr = current_attributes,
2175 .nattr = ARRAY_SIZE(current_attributes),
2178 .attr = power_attributes,
2179 .nattr = ARRAY_SIZE(power_attributes),
2181 .class = PSC_TEMPERATURE,
2182 .attr = temp_attributes,
2183 .nattr = ARRAY_SIZE(temp_attributes),
2188 * Read the coefficients for direct mode.
2190 static int pmbus_read_coefficients(struct i2c_client *client,
2191 struct pmbus_driver_info *info,
2192 const struct pmbus_sensor_attr *attr)
2195 union i2c_smbus_data data;
2196 enum pmbus_sensor_classes class = attr->class;
2201 data.block[1] = attr->reg;
2202 data.block[2] = 0x01;
2204 rv = i2c_smbus_xfer(client->adapter, client->addr, client->flags,
2205 I2C_SMBUS_WRITE, PMBUS_COEFFICIENTS,
2206 I2C_SMBUS_BLOCK_PROC_CALL, &data);
2211 if (data.block[0] != 5)
2214 m = data.block[1] | (data.block[2] << 8);
2215 b = data.block[3] | (data.block[4] << 8);
2224 static int pmbus_init_coefficients(struct i2c_client *client,
2225 struct pmbus_driver_info *info)
2227 int i, n, ret = -EINVAL;
2228 const struct pmbus_class_attr_map *map;
2229 const struct pmbus_sensor_attr *attr;
2231 for (i = 0; i < ARRAY_SIZE(class_attr_map); i++) {
2232 map = &class_attr_map[i];
2233 if (info->format[map->class] != direct)
2235 for (n = 0; n < map->nattr; n++) {
2236 attr = &map->attr[n];
2237 if (map->class != attr->class)
2239 ret = pmbus_read_coefficients(client, info, attr);
2244 dev_err(&client->dev,
2245 "No coefficients found for sensor class %d\n",
2255 * Identify chip parameters.
2256 * This function is called for all chips.
2258 static int pmbus_identify_common(struct i2c_client *client,
2259 struct pmbus_data *data, int page)
2263 if (pmbus_check_byte_register(client, page, PMBUS_VOUT_MODE))
2264 vout_mode = _pmbus_read_byte_data(client, page,
2266 if (vout_mode >= 0 && vout_mode != 0xff) {
2268 * Not all chips support the VOUT_MODE command,
2269 * so a failure to read it is not an error.
2271 switch (vout_mode >> 5) {
2272 case 0: /* linear mode */
2273 if (data->info->format[PSC_VOLTAGE_OUT] != linear)
2276 data->exponent[page] = ((s8)(vout_mode << 3)) >> 3;
2278 case 1: /* VID mode */
2279 if (data->info->format[PSC_VOLTAGE_OUT] != vid)
2282 case 2: /* direct mode */
2283 if (data->info->format[PSC_VOLTAGE_OUT] != direct)
2291 pmbus_clear_fault_page(client, page);
2295 static int pmbus_read_status_byte(struct i2c_client *client, int page)
2297 return _pmbus_read_byte_data(client, page, PMBUS_STATUS_BYTE);
2300 static int pmbus_read_status_word(struct i2c_client *client, int page)
2302 return _pmbus_read_word_data(client, page, 0xff, PMBUS_STATUS_WORD);
2305 static int pmbus_init_common(struct i2c_client *client, struct pmbus_data *data,
2306 struct pmbus_driver_info *info)
2308 struct device *dev = &client->dev;
2312 * Some PMBus chips don't support PMBUS_STATUS_WORD, so try
2313 * to use PMBUS_STATUS_BYTE instead if that is the case.
2314 * Bail out if both registers are not supported.
2316 data->read_status = pmbus_read_status_word;
2317 ret = i2c_smbus_read_word_data(client, PMBUS_STATUS_WORD);
2318 if (ret < 0 || ret == 0xffff) {
2319 data->read_status = pmbus_read_status_byte;
2320 ret = i2c_smbus_read_byte_data(client, PMBUS_STATUS_BYTE);
2321 if (ret < 0 || ret == 0xff) {
2322 dev_err(dev, "PMBus status register not found\n");
2326 data->has_status_word = true;
2329 /* Make sure PEC is disabled, will be enabled later if needed */
2330 client->flags &= ~I2C_CLIENT_PEC;
2332 /* Enable PEC if the controller and bus supports it */
2333 if (!(data->flags & PMBUS_NO_CAPABILITY)) {
2334 ret = i2c_smbus_read_byte_data(client, PMBUS_CAPABILITY);
2335 if (ret >= 0 && (ret & PB_CAPABILITY_ERROR_CHECK)) {
2336 if (i2c_check_functionality(client->adapter, I2C_FUNC_SMBUS_PEC)) {
2337 client->flags |= I2C_CLIENT_PEC;
2343 * Check if the chip is write protected. If it is, we can not clear
2344 * faults, and we should not try it. Also, in that case, writes into
2345 * limit registers need to be disabled.
2347 if (!(data->flags & PMBUS_NO_WRITE_PROTECT)) {
2348 ret = i2c_smbus_read_byte_data(client, PMBUS_WRITE_PROTECT);
2349 if (ret > 0 && (ret & PB_WP_ANY))
2350 data->flags |= PMBUS_WRITE_PROTECTED | PMBUS_SKIP_STATUS_CHECK;
2353 if (data->info->pages)
2354 pmbus_clear_faults(client);
2356 pmbus_clear_fault_page(client, -1);
2358 if (info->identify) {
2359 ret = (*info->identify)(client, info);
2361 dev_err(dev, "Chip identification failed\n");
2366 if (info->pages <= 0 || info->pages > PMBUS_PAGES) {
2367 dev_err(dev, "Bad number of PMBus pages: %d\n", info->pages);
2371 for (page = 0; page < info->pages; page++) {
2372 ret = pmbus_identify_common(client, data, page);
2374 dev_err(dev, "Failed to identify chip capabilities\n");
2379 if (data->flags & PMBUS_USE_COEFFICIENTS_CMD) {
2380 if (!i2c_check_functionality(client->adapter,
2381 I2C_FUNC_SMBUS_BLOCK_PROC_CALL))
2384 ret = pmbus_init_coefficients(client, info);
2392 #if IS_ENABLED(CONFIG_REGULATOR)
2393 static int pmbus_regulator_is_enabled(struct regulator_dev *rdev)
2395 struct device *dev = rdev_get_dev(rdev);
2396 struct i2c_client *client = to_i2c_client(dev->parent);
2397 struct pmbus_data *data = i2c_get_clientdata(client);
2398 u8 page = rdev_get_id(rdev);
2401 mutex_lock(&data->update_lock);
2402 ret = pmbus_read_byte_data(client, page, PMBUS_OPERATION);
2403 mutex_unlock(&data->update_lock);
2408 return !!(ret & PB_OPERATION_CONTROL_ON);
2411 static int _pmbus_regulator_on_off(struct regulator_dev *rdev, bool enable)
2413 struct device *dev = rdev_get_dev(rdev);
2414 struct i2c_client *client = to_i2c_client(dev->parent);
2415 struct pmbus_data *data = i2c_get_clientdata(client);
2416 u8 page = rdev_get_id(rdev);
2419 mutex_lock(&data->update_lock);
2420 ret = pmbus_update_byte_data(client, page, PMBUS_OPERATION,
2421 PB_OPERATION_CONTROL_ON,
2422 enable ? PB_OPERATION_CONTROL_ON : 0);
2423 mutex_unlock(&data->update_lock);
2428 static int pmbus_regulator_enable(struct regulator_dev *rdev)
2430 return _pmbus_regulator_on_off(rdev, 1);
2433 static int pmbus_regulator_disable(struct regulator_dev *rdev)
2435 return _pmbus_regulator_on_off(rdev, 0);
2438 /* A PMBus status flag and the corresponding REGULATOR_ERROR_* flag */
2439 struct pmbus_regulator_status_assoc {
2443 /* PMBus->regulator bit mappings for a PMBus status register */
2444 struct pmbus_regulator_status_category {
2447 const struct pmbus_regulator_status_assoc *bits; /* zero-terminated */
2450 static const struct pmbus_regulator_status_category pmbus_regulator_flag_map[] = {
2452 .func = PMBUS_HAVE_STATUS_VOUT,
2453 .reg = PMBUS_STATUS_VOUT,
2454 .bits = (const struct pmbus_regulator_status_assoc[]) {
2455 { PB_VOLTAGE_UV_WARNING, REGULATOR_ERROR_UNDER_VOLTAGE_WARN },
2456 { PB_VOLTAGE_UV_FAULT, REGULATOR_ERROR_UNDER_VOLTAGE },
2457 { PB_VOLTAGE_OV_WARNING, REGULATOR_ERROR_OVER_VOLTAGE_WARN },
2458 { PB_VOLTAGE_OV_FAULT, REGULATOR_ERROR_REGULATION_OUT },
2462 .func = PMBUS_HAVE_STATUS_IOUT,
2463 .reg = PMBUS_STATUS_IOUT,
2464 .bits = (const struct pmbus_regulator_status_assoc[]) {
2465 { PB_IOUT_OC_WARNING, REGULATOR_ERROR_OVER_CURRENT_WARN },
2466 { PB_IOUT_OC_FAULT, REGULATOR_ERROR_OVER_CURRENT },
2467 { PB_IOUT_OC_LV_FAULT, REGULATOR_ERROR_OVER_CURRENT },
2471 .func = PMBUS_HAVE_STATUS_TEMP,
2472 .reg = PMBUS_STATUS_TEMPERATURE,
2473 .bits = (const struct pmbus_regulator_status_assoc[]) {
2474 { PB_TEMP_OT_WARNING, REGULATOR_ERROR_OVER_TEMP_WARN },
2475 { PB_TEMP_OT_FAULT, REGULATOR_ERROR_OVER_TEMP },
2481 static int pmbus_regulator_get_error_flags(struct regulator_dev *rdev, unsigned int *flags)
2484 const struct pmbus_regulator_status_category *cat;
2485 const struct pmbus_regulator_status_assoc *bit;
2486 struct device *dev = rdev_get_dev(rdev);
2487 struct i2c_client *client = to_i2c_client(dev->parent);
2488 struct pmbus_data *data = i2c_get_clientdata(client);
2489 u8 page = rdev_get_id(rdev);
2490 int func = data->info->func[page];
2494 mutex_lock(&data->update_lock);
2496 for (i = 0; i < ARRAY_SIZE(pmbus_regulator_flag_map); i++) {
2497 cat = &pmbus_regulator_flag_map[i];
2498 if (!(func & cat->func))
2501 status = pmbus_read_byte_data(client, page, cat->reg);
2503 mutex_unlock(&data->update_lock);
2507 for (bit = cat->bits; bit->pflag; bit++) {
2508 if (status & bit->pflag)
2509 *flags |= bit->rflag;
2514 * Map what bits of STATUS_{WORD,BYTE} we can to REGULATOR_ERROR_*
2515 * bits. Some of the other bits are tempting (especially for cases
2516 * where we don't have the relevant PMBUS_HAVE_STATUS_*
2517 * functionality), but there's an unfortunate ambiguity in that
2518 * they're defined as indicating a fault *or* a warning, so we can't
2519 * easily determine whether to report REGULATOR_ERROR_<foo> or
2520 * REGULATOR_ERROR_<foo>_WARN.
2522 status = pmbus_get_status(client, page, PMBUS_STATUS_WORD);
2523 mutex_unlock(&data->update_lock);
2527 if (pmbus_regulator_is_enabled(rdev) && (status & PB_STATUS_OFF))
2528 *flags |= REGULATOR_ERROR_FAIL;
2531 * Unlike most other status bits, PB_STATUS_{IOUT_OC,VOUT_OV} are
2532 * defined strictly as fault indicators (not warnings).
2534 if (status & PB_STATUS_IOUT_OC)
2535 *flags |= REGULATOR_ERROR_OVER_CURRENT;
2536 if (status & PB_STATUS_VOUT_OV)
2537 *flags |= REGULATOR_ERROR_REGULATION_OUT;
2540 * If we haven't discovered any thermal faults or warnings via
2541 * PMBUS_STATUS_TEMPERATURE, map PB_STATUS_TEMPERATURE to a warning as
2542 * a (conservative) best-effort interpretation.
2544 if (!(*flags & (REGULATOR_ERROR_OVER_TEMP | REGULATOR_ERROR_OVER_TEMP_WARN)) &&
2545 (status & PB_STATUS_TEMPERATURE))
2546 *flags |= REGULATOR_ERROR_OVER_TEMP_WARN;
2551 const struct regulator_ops pmbus_regulator_ops = {
2552 .enable = pmbus_regulator_enable,
2553 .disable = pmbus_regulator_disable,
2554 .is_enabled = pmbus_regulator_is_enabled,
2555 .get_error_flags = pmbus_regulator_get_error_flags,
2557 EXPORT_SYMBOL_NS_GPL(pmbus_regulator_ops, PMBUS);
2559 static int pmbus_regulator_register(struct pmbus_data *data)
2561 struct device *dev = data->dev;
2562 const struct pmbus_driver_info *info = data->info;
2563 const struct pmbus_platform_data *pdata = dev_get_platdata(dev);
2564 struct regulator_dev *rdev;
2567 for (i = 0; i < info->num_regulators; i++) {
2568 struct regulator_config config = { };
2571 config.driver_data = data;
2573 if (pdata && pdata->reg_init_data)
2574 config.init_data = &pdata->reg_init_data[i];
2576 rdev = devm_regulator_register(dev, &info->reg_desc[i],
2579 dev_err(dev, "Failed to register %s regulator\n",
2580 info->reg_desc[i].name);
2581 return PTR_ERR(rdev);
2588 static int pmbus_regulator_register(struct pmbus_data *data)
2594 static struct dentry *pmbus_debugfs_dir; /* pmbus debugfs directory */
2596 #if IS_ENABLED(CONFIG_DEBUG_FS)
2597 static int pmbus_debugfs_get(void *data, u64 *val)
2600 struct pmbus_debugfs_entry *entry = data;
2602 rc = _pmbus_read_byte_data(entry->client, entry->page, entry->reg);
2610 DEFINE_DEBUGFS_ATTRIBUTE(pmbus_debugfs_ops, pmbus_debugfs_get, NULL,
2613 static int pmbus_debugfs_get_status(void *data, u64 *val)
2616 struct pmbus_debugfs_entry *entry = data;
2617 struct pmbus_data *pdata = i2c_get_clientdata(entry->client);
2619 rc = pdata->read_status(entry->client, entry->page);
2627 DEFINE_DEBUGFS_ATTRIBUTE(pmbus_debugfs_ops_status, pmbus_debugfs_get_status,
2628 NULL, "0x%04llx\n");
2630 static int pmbus_debugfs_get_pec(void *data, u64 *val)
2632 struct i2c_client *client = data;
2634 *val = !!(client->flags & I2C_CLIENT_PEC);
2639 static int pmbus_debugfs_set_pec(void *data, u64 val)
2642 struct i2c_client *client = data;
2645 client->flags &= ~I2C_CLIENT_PEC;
2652 rc = i2c_smbus_read_byte_data(client, PMBUS_CAPABILITY);
2656 if (!(rc & PB_CAPABILITY_ERROR_CHECK))
2659 client->flags |= I2C_CLIENT_PEC;
2663 DEFINE_DEBUGFS_ATTRIBUTE(pmbus_debugfs_ops_pec, pmbus_debugfs_get_pec,
2664 pmbus_debugfs_set_pec, "%llu\n");
2666 static void pmbus_remove_debugfs(void *data)
2668 struct dentry *entry = data;
2670 debugfs_remove_recursive(entry);
2673 static int pmbus_init_debugfs(struct i2c_client *client,
2674 struct pmbus_data *data)
2677 char name[PMBUS_NAME_SIZE];
2678 struct pmbus_debugfs_entry *entries;
2680 if (!pmbus_debugfs_dir)
2684 * Create the debugfs directory for this device. Use the hwmon device
2685 * name to avoid conflicts (hwmon numbers are globally unique).
2687 data->debugfs = debugfs_create_dir(dev_name(data->hwmon_dev),
2689 if (IS_ERR_OR_NULL(data->debugfs)) {
2690 data->debugfs = NULL;
2694 /* Allocate the max possible entries we need. */
2695 entries = devm_kcalloc(data->dev,
2696 data->info->pages * 10, sizeof(*entries),
2701 debugfs_create_file("pec", 0664, data->debugfs, client,
2702 &pmbus_debugfs_ops_pec);
2704 for (i = 0; i < data->info->pages; ++i) {
2705 /* Check accessibility of status register if it's not page 0 */
2706 if (!i || pmbus_check_status_register(client, i)) {
2707 /* No need to set reg as we have special read op. */
2708 entries[idx].client = client;
2709 entries[idx].page = i;
2710 scnprintf(name, PMBUS_NAME_SIZE, "status%d", i);
2711 debugfs_create_file(name, 0444, data->debugfs,
2713 &pmbus_debugfs_ops_status);
2716 if (data->info->func[i] & PMBUS_HAVE_STATUS_VOUT) {
2717 entries[idx].client = client;
2718 entries[idx].page = i;
2719 entries[idx].reg = PMBUS_STATUS_VOUT;
2720 scnprintf(name, PMBUS_NAME_SIZE, "status%d_vout", i);
2721 debugfs_create_file(name, 0444, data->debugfs,
2723 &pmbus_debugfs_ops);
2726 if (data->info->func[i] & PMBUS_HAVE_STATUS_IOUT) {
2727 entries[idx].client = client;
2728 entries[idx].page = i;
2729 entries[idx].reg = PMBUS_STATUS_IOUT;
2730 scnprintf(name, PMBUS_NAME_SIZE, "status%d_iout", i);
2731 debugfs_create_file(name, 0444, data->debugfs,
2733 &pmbus_debugfs_ops);
2736 if (data->info->func[i] & PMBUS_HAVE_STATUS_INPUT) {
2737 entries[idx].client = client;
2738 entries[idx].page = i;
2739 entries[idx].reg = PMBUS_STATUS_INPUT;
2740 scnprintf(name, PMBUS_NAME_SIZE, "status%d_input", i);
2741 debugfs_create_file(name, 0444, data->debugfs,
2743 &pmbus_debugfs_ops);
2746 if (data->info->func[i] & PMBUS_HAVE_STATUS_TEMP) {
2747 entries[idx].client = client;
2748 entries[idx].page = i;
2749 entries[idx].reg = PMBUS_STATUS_TEMPERATURE;
2750 scnprintf(name, PMBUS_NAME_SIZE, "status%d_temp", i);
2751 debugfs_create_file(name, 0444, data->debugfs,
2753 &pmbus_debugfs_ops);
2756 if (pmbus_check_byte_register(client, i, PMBUS_STATUS_CML)) {
2757 entries[idx].client = client;
2758 entries[idx].page = i;
2759 entries[idx].reg = PMBUS_STATUS_CML;
2760 scnprintf(name, PMBUS_NAME_SIZE, "status%d_cml", i);
2761 debugfs_create_file(name, 0444, data->debugfs,
2763 &pmbus_debugfs_ops);
2766 if (pmbus_check_byte_register(client, i, PMBUS_STATUS_OTHER)) {
2767 entries[idx].client = client;
2768 entries[idx].page = i;
2769 entries[idx].reg = PMBUS_STATUS_OTHER;
2770 scnprintf(name, PMBUS_NAME_SIZE, "status%d_other", i);
2771 debugfs_create_file(name, 0444, data->debugfs,
2773 &pmbus_debugfs_ops);
2776 if (pmbus_check_byte_register(client, i,
2777 PMBUS_STATUS_MFR_SPECIFIC)) {
2778 entries[idx].client = client;
2779 entries[idx].page = i;
2780 entries[idx].reg = PMBUS_STATUS_MFR_SPECIFIC;
2781 scnprintf(name, PMBUS_NAME_SIZE, "status%d_mfr", i);
2782 debugfs_create_file(name, 0444, data->debugfs,
2784 &pmbus_debugfs_ops);
2787 if (data->info->func[i] & PMBUS_HAVE_STATUS_FAN12) {
2788 entries[idx].client = client;
2789 entries[idx].page = i;
2790 entries[idx].reg = PMBUS_STATUS_FAN_12;
2791 scnprintf(name, PMBUS_NAME_SIZE, "status%d_fan12", i);
2792 debugfs_create_file(name, 0444, data->debugfs,
2794 &pmbus_debugfs_ops);
2797 if (data->info->func[i] & PMBUS_HAVE_STATUS_FAN34) {
2798 entries[idx].client = client;
2799 entries[idx].page = i;
2800 entries[idx].reg = PMBUS_STATUS_FAN_34;
2801 scnprintf(name, PMBUS_NAME_SIZE, "status%d_fan34", i);
2802 debugfs_create_file(name, 0444, data->debugfs,
2804 &pmbus_debugfs_ops);
2808 return devm_add_action_or_reset(data->dev,
2809 pmbus_remove_debugfs, data->debugfs);
2812 static int pmbus_init_debugfs(struct i2c_client *client,
2813 struct pmbus_data *data)
2817 #endif /* IS_ENABLED(CONFIG_DEBUG_FS) */
2819 int pmbus_do_probe(struct i2c_client *client, struct pmbus_driver_info *info)
2821 struct device *dev = &client->dev;
2822 const struct pmbus_platform_data *pdata = dev_get_platdata(dev);
2823 struct pmbus_data *data;
2824 size_t groups_num = 0;
2831 if (!i2c_check_functionality(client->adapter, I2C_FUNC_SMBUS_WRITE_BYTE
2832 | I2C_FUNC_SMBUS_BYTE_DATA
2833 | I2C_FUNC_SMBUS_WORD_DATA))
2836 data = devm_kzalloc(dev, sizeof(*data), GFP_KERNEL);
2841 while (info->groups[groups_num])
2844 data->groups = devm_kcalloc(dev, groups_num + 2, sizeof(void *),
2849 i2c_set_clientdata(client, data);
2850 mutex_init(&data->update_lock);
2854 data->flags = pdata->flags;
2856 data->currpage = -1;
2857 data->currphase = -1;
2859 ret = pmbus_init_common(client, data, info);
2863 ret = pmbus_find_attributes(client, data);
2868 * If there are no attributes, something is wrong.
2869 * Bail out instead of trying to register nothing.
2871 if (!data->num_attributes) {
2872 dev_err(dev, "No attributes found\n");
2876 name = devm_kstrdup(dev, client->name, GFP_KERNEL);
2879 strreplace(name, '-', '_');
2881 data->groups[0] = &data->group;
2882 memcpy(data->groups + 1, info->groups, sizeof(void *) * groups_num);
2883 data->hwmon_dev = devm_hwmon_device_register_with_groups(dev,
2884 name, data, data->groups);
2885 if (IS_ERR(data->hwmon_dev)) {
2886 dev_err(dev, "Failed to register hwmon device\n");
2887 return PTR_ERR(data->hwmon_dev);
2890 ret = pmbus_regulator_register(data);
2894 ret = pmbus_init_debugfs(client, data);
2896 dev_warn(dev, "Failed to register debugfs\n");
2900 EXPORT_SYMBOL_NS_GPL(pmbus_do_probe, PMBUS);
2902 struct dentry *pmbus_get_debugfs_dir(struct i2c_client *client)
2904 struct pmbus_data *data = i2c_get_clientdata(client);
2906 return data->debugfs;
2908 EXPORT_SYMBOL_NS_GPL(pmbus_get_debugfs_dir, PMBUS);
2910 static int __init pmbus_core_init(void)
2912 pmbus_debugfs_dir = debugfs_create_dir("pmbus", NULL);
2913 if (IS_ERR(pmbus_debugfs_dir))
2914 pmbus_debugfs_dir = NULL;
2919 static void __exit pmbus_core_exit(void)
2921 debugfs_remove_recursive(pmbus_debugfs_dir);
2924 module_init(pmbus_core_init);
2925 module_exit(pmbus_core_exit);
2927 MODULE_AUTHOR("Guenter Roeck");
2928 MODULE_DESCRIPTION("PMBus core driver");
2929 MODULE_LICENSE("GPL");