* [PATCH v2 0/3] hwmon: (pmbus): Add POWER System power supply driver
@ 2017-08-10 22:19 Eddie James
2017-08-10 22:19 ` [PATCH v2 1/3] dt-bindings: i2c: Document the POWER system power supply device Eddie James
` (2 more replies)
0 siblings, 3 replies; 10+ messages in thread
From: Eddie James @ 2017-08-10 22:19 UTC (permalink / raw)
To: linux
Cc: robh+dt, jdelvare, linux-kernel, linux-hwmon, joel, jk, andrew,
eajames, mark.rutland, devicetree, corbet, linux-doc,
Edward A. James
From: "Edward A. James" <eajames@us.ibm.com>
This series adds a hwmon pmbus driver for a POWER System power supply. The
core monitoring functionality is provided by pmbus.
This series depends on the pmbus core extensions for debugfs recently submitted
to the mailing list (latest: https://lkml.org/lkml/2017/8/10/881).
Since v1:
* Renamed the driver.
* Removed non-hwmon attributes.
* Simplified word and byte data reads.
Edward A. James (3):
dt-bindings: i2c: Document the POWER system power supply device
hwmon: (pmbus): Add POWER system power supply driver
Documentation: hwmon: Add POWER system power supply documentation
.../devicetree/bindings/i2c/ibm,power-ps.txt | 21 +++
Documentation/hwmon/powerps | 54 ++++++++
drivers/hwmon/pmbus/Kconfig | 10 ++
drivers/hwmon/pmbus/Makefile | 1 +
drivers/hwmon/pmbus/powerps.c | 144 +++++++++++++++++++++
5 files changed, 230 insertions(+)
create mode 100644 Documentation/devicetree/bindings/i2c/ibm,power-ps.txt
create mode 100644 Documentation/hwmon/powerps
create mode 100644 drivers/hwmon/pmbus/powerps.c
--
1.8.3.1
^ permalink raw reply [flat|nested] 10+ messages in thread* [PATCH v2 1/3] dt-bindings: i2c: Document the POWER system power supply device 2017-08-10 22:19 [PATCH v2 0/3] hwmon: (pmbus): Add POWER System power supply driver Eddie James @ 2017-08-10 22:19 ` Eddie James 2017-08-17 15:11 ` Rob Herring 2017-08-10 22:19 ` [PATCH v2 2/3] hwmon: (pmbus): Add POWER system power supply driver Eddie James 2017-08-10 22:19 ` [PATCH v2 3/3] Documentation: hwmon: Add POWER system power supply documentation Eddie James 2 siblings, 1 reply; 10+ messages in thread From: Eddie James @ 2017-08-10 22:19 UTC (permalink / raw) To: linux Cc: robh+dt, jdelvare, linux-kernel, linux-hwmon, joel, jk, andrew, eajames, mark.rutland, devicetree, corbet, linux-doc, Edward A. James From: "Edward A. James" <eajames@us.ibm.com> Signed-off-by: Edward A. James <eajames@us.ibm.com> --- .../devicetree/bindings/i2c/ibm,power-ps.txt | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 Documentation/devicetree/bindings/i2c/ibm,power-ps.txt diff --git a/Documentation/devicetree/bindings/i2c/ibm,power-ps.txt b/Documentation/devicetree/bindings/i2c/ibm,power-ps.txt new file mode 100644 index 0000000..2ea8ea2 --- /dev/null +++ b/Documentation/devicetree/bindings/i2c/ibm,power-ps.txt @@ -0,0 +1,21 @@ +Device-tree bindings for IBM POWER system power supplies +-------------------------------------------------------- + +Required properties: + - compatible = "ibm,power-ps"; + - reg = < I2C bus address >; : Address of the power supply on the + I2C bus. + +Example: + + i2c-bus@100 { + #address-cells = <1>; + #size-cells = <0>; + #interrupt-cells = <1>; + < more properties > + + power_ps@68 { + compatible = "ibm,power-ps"; + reg = <0x68>; + }; + }; -- 1.8.3.1 ^ permalink raw reply related [flat|nested] 10+ messages in thread
* Re: [PATCH v2 1/3] dt-bindings: i2c: Document the POWER system power supply device 2017-08-10 22:19 ` [PATCH v2 1/3] dt-bindings: i2c: Document the POWER system power supply device Eddie James @ 2017-08-17 15:11 ` Rob Herring 2017-08-21 18:35 ` Eddie James 0 siblings, 1 reply; 10+ messages in thread From: Rob Herring @ 2017-08-17 15:11 UTC (permalink / raw) To: Eddie James Cc: linux, jdelvare, linux-kernel, linux-hwmon, joel, jk, andrew, mark.rutland, devicetree, corbet, linux-doc, Edward A. James On Thu, Aug 10, 2017 at 05:19:44PM -0500, Eddie James wrote: > From: "Edward A. James" <eajames@us.ibm.com> > > Signed-off-by: Edward A. James <eajames@us.ibm.com> > --- > .../devicetree/bindings/i2c/ibm,power-ps.txt | 21 +++++++++++++++++++++ > 1 file changed, 21 insertions(+) > create mode 100644 Documentation/devicetree/bindings/i2c/ibm,power-ps.txt > > diff --git a/Documentation/devicetree/bindings/i2c/ibm,power-ps.txt b/Documentation/devicetree/bindings/i2c/ibm,power-ps.txt > new file mode 100644 > index 0000000..2ea8ea2 > --- /dev/null > +++ b/Documentation/devicetree/bindings/i2c/ibm,power-ps.txt > @@ -0,0 +1,21 @@ > +Device-tree bindings for IBM POWER system power supplies > +-------------------------------------------------------- > + > +Required properties: > + - compatible = "ibm,power-ps"; > + - reg = < I2C bus address >; : Address of the power supply on the > + I2C bus. > + > +Example: > + > + i2c-bus@100 { > + #address-cells = <1>; > + #size-cells = <0>; > + #interrupt-cells = <1>; > + < more properties > > + > + power_ps@68 { Don't use '_' in node names. Should be a generic name too if possible. Perhaps "power-supply". > + compatible = "ibm,power-ps"; > + reg = <0x68>; > + }; > + }; > -- > 1.8.3.1 > ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH v2 1/3] dt-bindings: i2c: Document the POWER system power supply device 2017-08-17 15:11 ` Rob Herring @ 2017-08-21 18:35 ` Eddie James 0 siblings, 0 replies; 10+ messages in thread From: Eddie James @ 2017-08-21 18:35 UTC (permalink / raw) To: Rob Herring Cc: linux, jdelvare, linux-kernel, linux-hwmon, joel, jk, andrew, mark.rutland, devicetree, corbet, linux-doc, Edward A. James On 08/17/2017 10:11 AM, Rob Herring wrote: > On Thu, Aug 10, 2017 at 05:19:44PM -0500, Eddie James wrote: >> From: "Edward A. James" <eajames@us.ibm.com> >> >> Signed-off-by: Edward A. James <eajames@us.ibm.com> >> --- >> .../devicetree/bindings/i2c/ibm,power-ps.txt | 21 +++++++++++++++++++++ >> 1 file changed, 21 insertions(+) >> create mode 100644 Documentation/devicetree/bindings/i2c/ibm,power-ps.txt >> >> diff --git a/Documentation/devicetree/bindings/i2c/ibm,power-ps.txt b/Documentation/devicetree/bindings/i2c/ibm,power-ps.txt >> new file mode 100644 >> index 0000000..2ea8ea2 >> --- /dev/null >> +++ b/Documentation/devicetree/bindings/i2c/ibm,power-ps.txt >> @@ -0,0 +1,21 @@ >> +Device-tree bindings for IBM POWER system power supplies >> +-------------------------------------------------------- >> + >> +Required properties: >> + - compatible = "ibm,power-ps"; >> + - reg = < I2C bus address >; : Address of the power supply on the >> + I2C bus. >> + >> +Example: >> + >> + i2c-bus@100 { >> + #address-cells = <1>; >> + #size-cells = <0>; >> + #interrupt-cells = <1>; >> + < more properties > >> + >> + power_ps@68 { > Don't use '_' in node names. Should be a generic name too if possible. > Perhaps "power-supply". Yes, the latest patch set switched this to power-supply. The driver name changed in v3, sorry for the confusion. Thanks, Eddie > >> + compatible = "ibm,power-ps"; >> + reg = <0x68>; >> + }; >> + }; >> -- >> 1.8.3.1 >> ^ permalink raw reply [flat|nested] 10+ messages in thread
* [PATCH v2 2/3] hwmon: (pmbus): Add POWER system power supply driver 2017-08-10 22:19 [PATCH v2 0/3] hwmon: (pmbus): Add POWER System power supply driver Eddie James 2017-08-10 22:19 ` [PATCH v2 1/3] dt-bindings: i2c: Document the POWER system power supply device Eddie James @ 2017-08-10 22:19 ` Eddie James 2017-08-11 1:18 ` Guenter Roeck 2017-08-10 22:19 ` [PATCH v2 3/3] Documentation: hwmon: Add POWER system power supply documentation Eddie James 2 siblings, 1 reply; 10+ messages in thread From: Eddie James @ 2017-08-10 22:19 UTC (permalink / raw) To: linux Cc: robh+dt, jdelvare, linux-kernel, linux-hwmon, joel, jk, andrew, eajames, mark.rutland, devicetree, corbet, linux-doc, Edward A. James From: "Edward A. James" <eajames@us.ibm.com> Add the driver to monitor POWER system power supplies with hwmon over pmbus. Signed-off-by: Edward A. James <eajames@us.ibm.com> --- drivers/hwmon/pmbus/Kconfig | 10 +++ drivers/hwmon/pmbus/Makefile | 1 + drivers/hwmon/pmbus/powerps.c | 144 ++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 155 insertions(+) create mode 100644 drivers/hwmon/pmbus/powerps.c diff --git a/drivers/hwmon/pmbus/Kconfig b/drivers/hwmon/pmbus/Kconfig index 68d717a..8925c1a 100644 --- a/drivers/hwmon/pmbus/Kconfig +++ b/drivers/hwmon/pmbus/Kconfig @@ -125,6 +125,16 @@ config SENSORS_MAX8688 This driver can also be built as a module. If so, the module will be called max8688. +config SENSORS_POWERPS + tristate "IBM POWER System Power Supply" + default n + help + If you say yes here you get hardware monitoring support for the IBM + POWER system power supply. + + This driver can also be built as a module. If so, the module will + be called powerps. + config SENSORS_TPS40422 tristate "TI TPS40422" default n diff --git a/drivers/hwmon/pmbus/Makefile b/drivers/hwmon/pmbus/Makefile index 75bb7ca..3303af5 100644 --- a/drivers/hwmon/pmbus/Makefile +++ b/drivers/hwmon/pmbus/Makefile @@ -13,6 +13,7 @@ obj-$(CONFIG_SENSORS_MAX16064) += max16064.o obj-$(CONFIG_SENSORS_MAX20751) += max20751.o obj-$(CONFIG_SENSORS_MAX34440) += max34440.o obj-$(CONFIG_SENSORS_MAX8688) += max8688.o +obj-$(CONFIG_SENSORS_POWERPS) += powerps.o obj-$(CONFIG_SENSORS_TPS40422) += tps40422.o obj-$(CONFIG_SENSORS_UCD9000) += ucd9000.o obj-$(CONFIG_SENSORS_UCD9200) += ucd9200.o diff --git a/drivers/hwmon/pmbus/powerps.c b/drivers/hwmon/pmbus/powerps.c new file mode 100644 index 0000000..21d28f2 --- /dev/null +++ b/drivers/hwmon/pmbus/powerps.c @@ -0,0 +1,144 @@ +/* + * Copyright 2017 IBM Corp. + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + */ + +#include <linux/device.h> +#include <linux/i2c.h> +#include <linux/jiffies.h> +#include <linux/module.h> + +#include "pmbus.h" + +/* STATUS_MFR_SPECIFIC bits */ +#define POWERPS_MFR_FAN_FAULT BIT(0) +#define POWERPS_MFR_THERMAL_FAULT BIT(1) +#define POWERPS_MFR_OV_FAULT BIT(2) +#define POWERPS_MFR_UV_FAULT BIT(3) +#define POWERPS_MFR_PS_KILL BIT(4) +#define POWERPS_MFR_OC_FAULT BIT(5) +#define POWERPS_MFR_VAUX_FAULT BIT(6) +#define POWERPS_MFR_CURRENT_SHARE_WARNING BIT(7) + +static int powerps_read_byte_data(struct i2c_client *client, int page, int reg) +{ + int rc, mfr; + + switch (reg) { + case PMBUS_STATUS_VOUT: + case PMBUS_STATUS_IOUT: + case PMBUS_STATUS_TEMPERATURE: + case PMBUS_STATUS_FAN_12: + rc = pmbus_read_byte_data(client, page, reg); + if (rc < 0) + return rc; + + mfr = pmbus_read_byte_data(client, page, + PMBUS_STATUS_MFR_SPECIFIC); + if (mfr < 0) + return rc; + + /* Add MFR_SPECIFIC bits to the standard pmbus status regs. */ + if (reg == PMBUS_STATUS_FAN_12) { + if (mfr & POWERPS_MFR_FAN_FAULT) + rc |= PB_FAN_FAN1_FAULT; + } else if (reg == PMBUS_STATUS_TEMPERATURE) { + if (mfr & POWERPS_MFR_THERMAL_FAULT) + rc |= PB_TEMP_OT_FAULT; + } else if (reg == PMBUS_STATUS_VOUT) { + if (mfr & + (POWERPS_MFR_OV_FAULT | POWERPS_MFR_VAUX_FAULT)) + rc |= PB_VOLTAGE_OV_FAULT; + if (mfr & POWERPS_MFR_UV_FAULT) + rc |= PB_VOLTAGE_UV_FAULT; + } else if (reg == PMBUS_STATUS_IOUT) { + if (mfr & POWERPS_MFR_OC_FAULT) + rc |= PB_IOUT_OC_FAULT; + if (mfr & POWERPS_MFR_CURRENT_SHARE_WARNING) + rc |= PB_CURRENT_SHARE_FAULT; + } + break; + default: + rc = -ENODATA; + break; + } + + return rc; +} + +static int powerps_read_word_data(struct i2c_client *client, int page, int reg) +{ + int rc, mfr; + + switch (reg) { + case PMBUS_STATUS_WORD: + rc = pmbus_read_word_data(client, page, reg); + if (rc < 0) + return rc; + + mfr = pmbus_read_byte_data(client, page, + PMBUS_STATUS_MFR_SPECIFIC); + if (mfr < 0) + return rc; + + if (mfr & POWERPS_MFR_PS_KILL) + rc |= PB_STATUS_OFF; + break; + default: + rc = -ENODATA; + break; + } + + return rc; +} + +static struct pmbus_driver_info powerps_info = { + .pages = 1, + .func[0] = PMBUS_HAVE_VIN | PMBUS_HAVE_VOUT | PMBUS_HAVE_IOUT | + PMBUS_HAVE_PIN | PMBUS_HAVE_FAN12 | PMBUS_HAVE_TEMP | + PMBUS_HAVE_TEMP2 | PMBUS_HAVE_TEMP3 | PMBUS_HAVE_STATUS_VOUT | + PMBUS_HAVE_STATUS_IOUT | PMBUS_HAVE_STATUS_INPUT | + PMBUS_HAVE_STATUS_TEMP | PMBUS_HAVE_STATUS_FAN12, + .read_byte_data = powerps_read_byte_data, + .read_word_data = powerps_read_word_data, + .debugfs = true, +}; + +static int powerps_probe(struct i2c_client *client, + const struct i2c_device_id *id) +{ + return pmbus_do_probe(client, id, &powerps_info); +} + +static const struct i2c_device_id powerps_id[] = { + { "power_ps", 1 }, + {} +}; +MODULE_DEVICE_TABLE(i2c, powerps_id); + +/* IBM provides many compatible power supplies; use a generic name. */ +static const struct of_device_id powerps_of_match[] = { + { .compatible = "ibm,power-ps" }, + {} +}; +MODULE_DEVICE_TABLE(of, powerps_of_match); + +static struct i2c_driver powerps_driver = { + .driver = { + .name = "powerps", + .of_match_table = powerps_of_match, + }, + .probe = powerps_probe, + .remove = pmbus_do_remove, + .id_table = powerps_id, +}; + +module_i2c_driver(powerps_driver); + +MODULE_AUTHOR("Eddie James"); +MODULE_DESCRIPTION("PMBus driver for POWER system power supplies"); +MODULE_LICENSE("GPL"); -- 1.8.3.1 ^ permalink raw reply related [flat|nested] 10+ messages in thread
* Re: [PATCH v2 2/3] hwmon: (pmbus): Add POWER system power supply driver 2017-08-10 22:19 ` [PATCH v2 2/3] hwmon: (pmbus): Add POWER system power supply driver Eddie James @ 2017-08-11 1:18 ` Guenter Roeck 2017-08-11 14:30 ` Eddie James 0 siblings, 1 reply; 10+ messages in thread From: Guenter Roeck @ 2017-08-11 1:18 UTC (permalink / raw) To: Eddie James Cc: robh+dt, jdelvare, linux-kernel, linux-hwmon, joel, jk, andrew, mark.rutland, devicetree, corbet, linux-doc, Edward A. James On Thu, Aug 10, 2017 at 05:19:45PM -0500, Eddie James wrote: > From: "Edward A. James" <eajames@us.ibm.com> > > Add the driver to monitor POWER system power supplies with hwmon over > pmbus. > > Signed-off-by: Edward A. James <eajames@us.ibm.com> > --- > drivers/hwmon/pmbus/Kconfig | 10 +++ > drivers/hwmon/pmbus/Makefile | 1 + > drivers/hwmon/pmbus/powerps.c | 144 ++++++++++++++++++++++++++++++++++++++++++ > 3 files changed, 155 insertions(+) > create mode 100644 drivers/hwmon/pmbus/powerps.c > > diff --git a/drivers/hwmon/pmbus/Kconfig b/drivers/hwmon/pmbus/Kconfig > index 68d717a..8925c1a 100644 > --- a/drivers/hwmon/pmbus/Kconfig > +++ b/drivers/hwmon/pmbus/Kconfig > @@ -125,6 +125,16 @@ config SENSORS_MAX8688 > This driver can also be built as a module. If so, the module will > be called max8688. > > +config SENSORS_POWERPS > + tristate "IBM POWER System Power Supply" > + default n > + help > + If you say yes here you get hardware monitoring support for the IBM > + POWER system power supply. > + > + This driver can also be built as a module. If so, the module will > + be called powerps. > + > config SENSORS_TPS40422 > tristate "TI TPS40422" > default n > diff --git a/drivers/hwmon/pmbus/Makefile b/drivers/hwmon/pmbus/Makefile > index 75bb7ca..3303af5 100644 > --- a/drivers/hwmon/pmbus/Makefile > +++ b/drivers/hwmon/pmbus/Makefile > @@ -13,6 +13,7 @@ obj-$(CONFIG_SENSORS_MAX16064) += max16064.o > obj-$(CONFIG_SENSORS_MAX20751) += max20751.o > obj-$(CONFIG_SENSORS_MAX34440) += max34440.o > obj-$(CONFIG_SENSORS_MAX8688) += max8688.o > +obj-$(CONFIG_SENSORS_POWERPS) += powerps.o > obj-$(CONFIG_SENSORS_TPS40422) += tps40422.o > obj-$(CONFIG_SENSORS_UCD9000) += ucd9000.o > obj-$(CONFIG_SENSORS_UCD9200) += ucd9200.o > diff --git a/drivers/hwmon/pmbus/powerps.c b/drivers/hwmon/pmbus/powerps.c > new file mode 100644 > index 0000000..21d28f2 > --- /dev/null > +++ b/drivers/hwmon/pmbus/powerps.c > @@ -0,0 +1,144 @@ > +/* > + * Copyright 2017 IBM Corp. > + * > + * This program is free software; you can redistribute it and/or modify > + * it under the terms of the GNU General Public License as published by > + * the Free Software Foundation; either version 2 of the License, or > + * (at your option) any later version. > + */ > + > +#include <linux/device.h> > +#include <linux/i2c.h> > +#include <linux/jiffies.h> > +#include <linux/module.h> > + > +#include "pmbus.h" > + > +/* STATUS_MFR_SPECIFIC bits */ > +#define POWERPS_MFR_FAN_FAULT BIT(0) > +#define POWERPS_MFR_THERMAL_FAULT BIT(1) > +#define POWERPS_MFR_OV_FAULT BIT(2) > +#define POWERPS_MFR_UV_FAULT BIT(3) > +#define POWERPS_MFR_PS_KILL BIT(4) > +#define POWERPS_MFR_OC_FAULT BIT(5) > +#define POWERPS_MFR_VAUX_FAULT BIT(6) > +#define POWERPS_MFR_CURRENT_SHARE_WARNING BIT(7) > + > +static int powerps_read_byte_data(struct i2c_client *client, int page, int reg) > +{ > + int rc, mfr; > + > + switch (reg) { > + case PMBUS_STATUS_VOUT: > + case PMBUS_STATUS_IOUT: > + case PMBUS_STATUS_TEMPERATURE: > + case PMBUS_STATUS_FAN_12: > + rc = pmbus_read_byte_data(client, page, reg); > + if (rc < 0) > + return rc; > + > + mfr = pmbus_read_byte_data(client, page, > + PMBUS_STATUS_MFR_SPECIFIC); > + if (mfr < 0) > + return rc; return mfr; ? > + > + /* Add MFR_SPECIFIC bits to the standard pmbus status regs. */ > + if (reg == PMBUS_STATUS_FAN_12) { > + if (mfr & POWERPS_MFR_FAN_FAULT) > + rc |= PB_FAN_FAN1_FAULT; > + } else if (reg == PMBUS_STATUS_TEMPERATURE) { > + if (mfr & POWERPS_MFR_THERMAL_FAULT) > + rc |= PB_TEMP_OT_FAULT; > + } else if (reg == PMBUS_STATUS_VOUT) { > + if (mfr & > + (POWERPS_MFR_OV_FAULT | POWERPS_MFR_VAUX_FAULT)) Wondering - this suggests that there is a VAUX. Would it make sense to map it to PMBUS_VIRT_READ_VMON ? > + rc |= PB_VOLTAGE_OV_FAULT; > + if (mfr & POWERPS_MFR_UV_FAULT) > + rc |= PB_VOLTAGE_UV_FAULT; > + } else if (reg == PMBUS_STATUS_IOUT) { > + if (mfr & POWERPS_MFR_OC_FAULT) > + rc |= PB_IOUT_OC_FAULT; > + if (mfr & POWERPS_MFR_CURRENT_SHARE_WARNING) > + rc |= PB_CURRENT_SHARE_FAULT; > + } > + break; > + default: > + rc = -ENODATA; > + break; > + } > + > + return rc; > +} > + > +static int powerps_read_word_data(struct i2c_client *client, int page, int reg) > +{ > + int rc, mfr; > + > + switch (reg) { > + case PMBUS_STATUS_WORD: > + rc = pmbus_read_word_data(client, page, reg); > + if (rc < 0) > + return rc; > + > + mfr = pmbus_read_byte_data(client, page, > + PMBUS_STATUS_MFR_SPECIFIC); > + if (mfr < 0) > + return rc; return mfr; ? > + > + if (mfr & POWERPS_MFR_PS_KILL) > + rc |= PB_STATUS_OFF; > + break; > + default: > + rc = -ENODATA; > + break; > + } > + > + return rc; > +} > + > +static struct pmbus_driver_info powerps_info = { > + .pages = 1, > + .func[0] = PMBUS_HAVE_VIN | PMBUS_HAVE_VOUT | PMBUS_HAVE_IOUT | > + PMBUS_HAVE_PIN | PMBUS_HAVE_FAN12 | PMBUS_HAVE_TEMP | > + PMBUS_HAVE_TEMP2 | PMBUS_HAVE_TEMP3 | PMBUS_HAVE_STATUS_VOUT | > + PMBUS_HAVE_STATUS_IOUT | PMBUS_HAVE_STATUS_INPUT | > + PMBUS_HAVE_STATUS_TEMP | PMBUS_HAVE_STATUS_FAN12, > + .read_byte_data = powerps_read_byte_data, > + .read_word_data = powerps_read_word_data, > + .debugfs = true, > +}; > + > +static int powerps_probe(struct i2c_client *client, > + const struct i2c_device_id *id) > +{ > + return pmbus_do_probe(client, id, &powerps_info); > +} > + > +static const struct i2c_device_id powerps_id[] = { > + { "power_ps", 1 }, > + {} > +}; > +MODULE_DEVICE_TABLE(i2c, powerps_id); > + > +/* IBM provides many compatible power supplies; use a generic name. */ > +static const struct of_device_id powerps_of_match[] = { > + { .compatible = "ibm,power-ps" }, > + {} > +}; > +MODULE_DEVICE_TABLE(of, powerps_of_match); > + > +static struct i2c_driver powerps_driver = { > + .driver = { > + .name = "powerps", > + .of_match_table = powerps_of_match, > + }, > + .probe = powerps_probe, > + .remove = pmbus_do_remove, > + .id_table = powerps_id, > +}; > + > +module_i2c_driver(powerps_driver); > + > +MODULE_AUTHOR("Eddie James"); > +MODULE_DESCRIPTION("PMBus driver for POWER system power supplies"); > +MODULE_LICENSE("GPL"); > -- > 1.8.3.1 > ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH v2 2/3] hwmon: (pmbus): Add POWER system power supply driver 2017-08-11 1:18 ` Guenter Roeck @ 2017-08-11 14:30 ` Eddie James 2017-08-11 18:27 ` Guenter Roeck 0 siblings, 1 reply; 10+ messages in thread From: Eddie James @ 2017-08-11 14:30 UTC (permalink / raw) To: Guenter Roeck Cc: robh+dt, jdelvare, linux-kernel, linux-hwmon, joel, jk, andrew, mark.rutland, devicetree, corbet, linux-doc, Edward A. James On 08/10/2017 08:18 PM, Guenter Roeck wrote: > On Thu, Aug 10, 2017 at 05:19:45PM -0500, Eddie James wrote: >> From: "Edward A. James" <eajames@us.ibm.com> >> >> Add the driver to monitor POWER system power supplies with hwmon over >> pmbus. >> >> Signed-off-by: Edward A. James <eajames@us.ibm.com> >> --- >> drivers/hwmon/pmbus/Kconfig | 10 +++ >> drivers/hwmon/pmbus/Makefile | 1 + >> drivers/hwmon/pmbus/powerps.c | 144 ++++++++++++++++++++++++++++++++++++++++++ >> 3 files changed, 155 insertions(+) >> create mode 100644 drivers/hwmon/pmbus/powerps.c >> >> diff --git a/drivers/hwmon/pmbus/Kconfig b/drivers/hwmon/pmbus/Kconfig >> index 68d717a..8925c1a 100644 >> --- a/drivers/hwmon/pmbus/Kconfig >> +++ b/drivers/hwmon/pmbus/Kconfig >> @@ -125,6 +125,16 @@ config SENSORS_MAX8688 >> This driver can also be built as a module. If so, the module will >> be called max8688. >> >> +config SENSORS_POWERPS >> + tristate "IBM POWER System Power Supply" >> + default n >> + help >> + If you say yes here you get hardware monitoring support for the IBM >> + POWER system power supply. >> + >> + This driver can also be built as a module. If so, the module will >> + be called powerps. >> + >> config SENSORS_TPS40422 >> tristate "TI TPS40422" >> default n >> diff --git a/drivers/hwmon/pmbus/Makefile b/drivers/hwmon/pmbus/Makefile >> index 75bb7ca..3303af5 100644 >> --- a/drivers/hwmon/pmbus/Makefile >> +++ b/drivers/hwmon/pmbus/Makefile >> @@ -13,6 +13,7 @@ obj-$(CONFIG_SENSORS_MAX16064) += max16064.o >> obj-$(CONFIG_SENSORS_MAX20751) += max20751.o >> obj-$(CONFIG_SENSORS_MAX34440) += max34440.o >> obj-$(CONFIG_SENSORS_MAX8688) += max8688.o >> +obj-$(CONFIG_SENSORS_POWERPS) += powerps.o >> obj-$(CONFIG_SENSORS_TPS40422) += tps40422.o >> obj-$(CONFIG_SENSORS_UCD9000) += ucd9000.o >> obj-$(CONFIG_SENSORS_UCD9200) += ucd9200.o >> diff --git a/drivers/hwmon/pmbus/powerps.c b/drivers/hwmon/pmbus/powerps.c >> new file mode 100644 >> index 0000000..21d28f2 >> --- /dev/null >> +++ b/drivers/hwmon/pmbus/powerps.c >> @@ -0,0 +1,144 @@ >> +/* >> + * Copyright 2017 IBM Corp. >> + * >> + * This program is free software; you can redistribute it and/or modify >> + * it under the terms of the GNU General Public License as published by >> + * the Free Software Foundation; either version 2 of the License, or >> + * (at your option) any later version. >> + */ >> + >> +#include <linux/device.h> >> +#include <linux/i2c.h> >> +#include <linux/jiffies.h> >> +#include <linux/module.h> >> + >> +#include "pmbus.h" >> + >> +/* STATUS_MFR_SPECIFIC bits */ >> +#define POWERPS_MFR_FAN_FAULT BIT(0) >> +#define POWERPS_MFR_THERMAL_FAULT BIT(1) >> +#define POWERPS_MFR_OV_FAULT BIT(2) >> +#define POWERPS_MFR_UV_FAULT BIT(3) >> +#define POWERPS_MFR_PS_KILL BIT(4) >> +#define POWERPS_MFR_OC_FAULT BIT(5) >> +#define POWERPS_MFR_VAUX_FAULT BIT(6) >> +#define POWERPS_MFR_CURRENT_SHARE_WARNING BIT(7) >> + >> +static int powerps_read_byte_data(struct i2c_client *client, int page, int reg) >> +{ >> + int rc, mfr; >> + >> + switch (reg) { >> + case PMBUS_STATUS_VOUT: >> + case PMBUS_STATUS_IOUT: >> + case PMBUS_STATUS_TEMPERATURE: >> + case PMBUS_STATUS_FAN_12: >> + rc = pmbus_read_byte_data(client, page, reg); >> + if (rc < 0) >> + return rc; >> + >> + mfr = pmbus_read_byte_data(client, page, >> + PMBUS_STATUS_MFR_SPECIFIC); >> + if (mfr < 0) >> + return rc; > return mfr; ? Well I returned rc because we read the status register without error, so just return the status register contents without the additional mfr bits. It's not very clear... I better add a comment. > >> + >> + /* Add MFR_SPECIFIC bits to the standard pmbus status regs. */ >> + if (reg == PMBUS_STATUS_FAN_12) { >> + if (mfr & POWERPS_MFR_FAN_FAULT) >> + rc |= PB_FAN_FAN1_FAULT; >> + } else if (reg == PMBUS_STATUS_TEMPERATURE) { >> + if (mfr & POWERPS_MFR_THERMAL_FAULT) >> + rc |= PB_TEMP_OT_FAULT; >> + } else if (reg == PMBUS_STATUS_VOUT) { >> + if (mfr & >> + (POWERPS_MFR_OV_FAULT | POWERPS_MFR_VAUX_FAULT)) > Wondering - this suggests that there is a VAUX. Would it make sense > to map it to PMBUS_VIRT_READ_VMON ? There is no VAUX for this device. The power supply spec calls it "12Vaux Fault" but I don't know why. Thanks for the quick review! Eddie > >> + rc |= PB_VOLTAGE_OV_FAULT; >> + if (mfr & POWERPS_MFR_UV_FAULT) >> + rc |= PB_VOLTAGE_UV_FAULT; >> + } else if (reg == PMBUS_STATUS_IOUT) { >> + if (mfr & POWERPS_MFR_OC_FAULT) >> + rc |= PB_IOUT_OC_FAULT; >> + if (mfr & POWERPS_MFR_CURRENT_SHARE_WARNING) >> + rc |= PB_CURRENT_SHARE_FAULT; >> + } >> + break; >> + default: >> + rc = -ENODATA; >> + break; >> + } >> + >> + return rc; >> +} >> + >> +static int powerps_read_word_data(struct i2c_client *client, int page, int reg) >> +{ >> + int rc, mfr; >> + >> + switch (reg) { >> + case PMBUS_STATUS_WORD: >> + rc = pmbus_read_word_data(client, page, reg); >> + if (rc < 0) >> + return rc; >> + >> + mfr = pmbus_read_byte_data(client, page, >> + PMBUS_STATUS_MFR_SPECIFIC); >> + if (mfr < 0) >> + return rc; > return mfr; ? > >> + >> + if (mfr & POWERPS_MFR_PS_KILL) >> + rc |= PB_STATUS_OFF; >> + break; >> + default: >> + rc = -ENODATA; >> + break; >> + } >> + >> + return rc; >> +} >> + >> +static struct pmbus_driver_info powerps_info = { >> + .pages = 1, >> + .func[0] = PMBUS_HAVE_VIN | PMBUS_HAVE_VOUT | PMBUS_HAVE_IOUT | >> + PMBUS_HAVE_PIN | PMBUS_HAVE_FAN12 | PMBUS_HAVE_TEMP | >> + PMBUS_HAVE_TEMP2 | PMBUS_HAVE_TEMP3 | PMBUS_HAVE_STATUS_VOUT | >> + PMBUS_HAVE_STATUS_IOUT | PMBUS_HAVE_STATUS_INPUT | >> + PMBUS_HAVE_STATUS_TEMP | PMBUS_HAVE_STATUS_FAN12, >> + .read_byte_data = powerps_read_byte_data, >> + .read_word_data = powerps_read_word_data, >> + .debugfs = true, >> +}; >> + >> +static int powerps_probe(struct i2c_client *client, >> + const struct i2c_device_id *id) >> +{ >> + return pmbus_do_probe(client, id, &powerps_info); >> +} >> + >> +static const struct i2c_device_id powerps_id[] = { >> + { "power_ps", 1 }, >> + {} >> +}; >> +MODULE_DEVICE_TABLE(i2c, powerps_id); >> + >> +/* IBM provides many compatible power supplies; use a generic name. */ >> +static const struct of_device_id powerps_of_match[] = { >> + { .compatible = "ibm,power-ps" }, >> + {} >> +}; >> +MODULE_DEVICE_TABLE(of, powerps_of_match); >> + >> +static struct i2c_driver powerps_driver = { >> + .driver = { >> + .name = "powerps", >> + .of_match_table = powerps_of_match, >> + }, >> + .probe = powerps_probe, >> + .remove = pmbus_do_remove, >> + .id_table = powerps_id, >> +}; >> + >> +module_i2c_driver(powerps_driver); >> + >> +MODULE_AUTHOR("Eddie James"); >> +MODULE_DESCRIPTION("PMBus driver for POWER system power supplies"); >> +MODULE_LICENSE("GPL"); >> -- >> 1.8.3.1 >> ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH v2 2/3] hwmon: (pmbus): Add POWER system power supply driver 2017-08-11 14:30 ` Eddie James @ 2017-08-11 18:27 ` Guenter Roeck 0 siblings, 0 replies; 10+ messages in thread From: Guenter Roeck @ 2017-08-11 18:27 UTC (permalink / raw) To: Eddie James Cc: robh+dt, jdelvare, linux-kernel, linux-hwmon, joel, jk, andrew, mark.rutland, devicetree, corbet, linux-doc, Edward A. James On Fri, Aug 11, 2017 at 09:30:59AM -0500, Eddie James wrote: > > > On 08/10/2017 08:18 PM, Guenter Roeck wrote: > >On Thu, Aug 10, 2017 at 05:19:45PM -0500, Eddie James wrote: > >>From: "Edward A. James" <eajames@us.ibm.com> > >> > >>Add the driver to monitor POWER system power supplies with hwmon over > >>pmbus. > >> > >>Signed-off-by: Edward A. James <eajames@us.ibm.com> > >>--- > >> drivers/hwmon/pmbus/Kconfig | 10 +++ > >> drivers/hwmon/pmbus/Makefile | 1 + > >> drivers/hwmon/pmbus/powerps.c | 144 ++++++++++++++++++++++++++++++++++++++++++ > >> 3 files changed, 155 insertions(+) > >> create mode 100644 drivers/hwmon/pmbus/powerps.c > >> > >>diff --git a/drivers/hwmon/pmbus/Kconfig b/drivers/hwmon/pmbus/Kconfig > >>index 68d717a..8925c1a 100644 > >>--- a/drivers/hwmon/pmbus/Kconfig > >>+++ b/drivers/hwmon/pmbus/Kconfig > >>@@ -125,6 +125,16 @@ config SENSORS_MAX8688 > >> This driver can also be built as a module. If so, the module will > >> be called max8688. > >>+config SENSORS_POWERPS > >>+ tristate "IBM POWER System Power Supply" > >>+ default n > >>+ help > >>+ If you say yes here you get hardware monitoring support for the IBM > >>+ POWER system power supply. > >>+ > >>+ This driver can also be built as a module. If so, the module will > >>+ be called powerps. > >>+ > >> config SENSORS_TPS40422 > >> tristate "TI TPS40422" > >> default n > >>diff --git a/drivers/hwmon/pmbus/Makefile b/drivers/hwmon/pmbus/Makefile > >>index 75bb7ca..3303af5 100644 > >>--- a/drivers/hwmon/pmbus/Makefile > >>+++ b/drivers/hwmon/pmbus/Makefile > >>@@ -13,6 +13,7 @@ obj-$(CONFIG_SENSORS_MAX16064) += max16064.o > >> obj-$(CONFIG_SENSORS_MAX20751) += max20751.o > >> obj-$(CONFIG_SENSORS_MAX34440) += max34440.o > >> obj-$(CONFIG_SENSORS_MAX8688) += max8688.o > >>+obj-$(CONFIG_SENSORS_POWERPS) += powerps.o > >> obj-$(CONFIG_SENSORS_TPS40422) += tps40422.o > >> obj-$(CONFIG_SENSORS_UCD9000) += ucd9000.o > >> obj-$(CONFIG_SENSORS_UCD9200) += ucd9200.o > >>diff --git a/drivers/hwmon/pmbus/powerps.c b/drivers/hwmon/pmbus/powerps.c > >>new file mode 100644 > >>index 0000000..21d28f2 > >>--- /dev/null > >>+++ b/drivers/hwmon/pmbus/powerps.c > >>@@ -0,0 +1,144 @@ > >>+/* > >>+ * Copyright 2017 IBM Corp. > >>+ * > >>+ * This program is free software; you can redistribute it and/or modify > >>+ * it under the terms of the GNU General Public License as published by > >>+ * the Free Software Foundation; either version 2 of the License, or > >>+ * (at your option) any later version. > >>+ */ > >>+ > >>+#include <linux/device.h> > >>+#include <linux/i2c.h> > >>+#include <linux/jiffies.h> > >>+#include <linux/module.h> > >>+ > >>+#include "pmbus.h" > >>+ > >>+/* STATUS_MFR_SPECIFIC bits */ > >>+#define POWERPS_MFR_FAN_FAULT BIT(0) > >>+#define POWERPS_MFR_THERMAL_FAULT BIT(1) > >>+#define POWERPS_MFR_OV_FAULT BIT(2) > >>+#define POWERPS_MFR_UV_FAULT BIT(3) > >>+#define POWERPS_MFR_PS_KILL BIT(4) > >>+#define POWERPS_MFR_OC_FAULT BIT(5) > >>+#define POWERPS_MFR_VAUX_FAULT BIT(6) > >>+#define POWERPS_MFR_CURRENT_SHARE_WARNING BIT(7) > >>+ > >>+static int powerps_read_byte_data(struct i2c_client *client, int page, int reg) > >>+{ > >>+ int rc, mfr; > >>+ > >>+ switch (reg) { > >>+ case PMBUS_STATUS_VOUT: > >>+ case PMBUS_STATUS_IOUT: > >>+ case PMBUS_STATUS_TEMPERATURE: > >>+ case PMBUS_STATUS_FAN_12: > >>+ rc = pmbus_read_byte_data(client, page, reg); > >>+ if (rc < 0) > >>+ return rc; > >>+ > >>+ mfr = pmbus_read_byte_data(client, page, > >>+ PMBUS_STATUS_MFR_SPECIFIC); > >>+ if (mfr < 0) > >>+ return rc; > > return mfr; ? > > Well I returned rc because we read the status register without error, so > just return the status register contents without the additional mfr bits. > It's not very clear... I better add a comment. > Ah, yes, that makes sense. Agreed, please add a comment. > > > >>+ > >>+ /* Add MFR_SPECIFIC bits to the standard pmbus status regs. */ > >>+ if (reg == PMBUS_STATUS_FAN_12) { > >>+ if (mfr & POWERPS_MFR_FAN_FAULT) > >>+ rc |= PB_FAN_FAN1_FAULT; > >>+ } else if (reg == PMBUS_STATUS_TEMPERATURE) { > >>+ if (mfr & POWERPS_MFR_THERMAL_FAULT) > >>+ rc |= PB_TEMP_OT_FAULT; > >>+ } else if (reg == PMBUS_STATUS_VOUT) { > >>+ if (mfr & > >>+ (POWERPS_MFR_OV_FAULT | POWERPS_MFR_VAUX_FAULT)) > >Wondering - this suggests that there is a VAUX. Would it make sense > >to map it to PMBUS_VIRT_READ_VMON ? > > There is no VAUX for this device. The power supply spec calls it "12Vaux > Fault" but I don't know why. > power supply designers having some fun ;-) Guenter > Thanks for the quick review! > Eddie > > > > >>+ rc |= PB_VOLTAGE_OV_FAULT; > >>+ if (mfr & POWERPS_MFR_UV_FAULT) > >>+ rc |= PB_VOLTAGE_UV_FAULT; > >>+ } else if (reg == PMBUS_STATUS_IOUT) { > >>+ if (mfr & POWERPS_MFR_OC_FAULT) > >>+ rc |= PB_IOUT_OC_FAULT; > >>+ if (mfr & POWERPS_MFR_CURRENT_SHARE_WARNING) > >>+ rc |= PB_CURRENT_SHARE_FAULT; > >>+ } > >>+ break; > >>+ default: > >>+ rc = -ENODATA; > >>+ break; > >>+ } > >>+ > >>+ return rc; > >>+} > >>+ > >>+static int powerps_read_word_data(struct i2c_client *client, int page, int reg) > >>+{ > >>+ int rc, mfr; > >>+ > >>+ switch (reg) { > >>+ case PMBUS_STATUS_WORD: > >>+ rc = pmbus_read_word_data(client, page, reg); > >>+ if (rc < 0) > >>+ return rc; > >>+ > >>+ mfr = pmbus_read_byte_data(client, page, > >>+ PMBUS_STATUS_MFR_SPECIFIC); > >>+ if (mfr < 0) > >>+ return rc; > > return mfr; ? > > > >>+ > >>+ if (mfr & POWERPS_MFR_PS_KILL) > >>+ rc |= PB_STATUS_OFF; > >>+ break; > >>+ default: > >>+ rc = -ENODATA; > >>+ break; > >>+ } > >>+ > >>+ return rc; > >>+} > >>+ > >>+static struct pmbus_driver_info powerps_info = { > >>+ .pages = 1, > >>+ .func[0] = PMBUS_HAVE_VIN | PMBUS_HAVE_VOUT | PMBUS_HAVE_IOUT | > >>+ PMBUS_HAVE_PIN | PMBUS_HAVE_FAN12 | PMBUS_HAVE_TEMP | > >>+ PMBUS_HAVE_TEMP2 | PMBUS_HAVE_TEMP3 | PMBUS_HAVE_STATUS_VOUT | > >>+ PMBUS_HAVE_STATUS_IOUT | PMBUS_HAVE_STATUS_INPUT | > >>+ PMBUS_HAVE_STATUS_TEMP | PMBUS_HAVE_STATUS_FAN12, > >>+ .read_byte_data = powerps_read_byte_data, > >>+ .read_word_data = powerps_read_word_data, > >>+ .debugfs = true, > >>+}; > >>+ > >>+static int powerps_probe(struct i2c_client *client, > >>+ const struct i2c_device_id *id) > >>+{ > >>+ return pmbus_do_probe(client, id, &powerps_info); > >>+} > >>+ > >>+static const struct i2c_device_id powerps_id[] = { > >>+ { "power_ps", 1 }, > >>+ {} > >>+}; > >>+MODULE_DEVICE_TABLE(i2c, powerps_id); > >>+ > >>+/* IBM provides many compatible power supplies; use a generic name. */ > >>+static const struct of_device_id powerps_of_match[] = { > >>+ { .compatible = "ibm,power-ps" }, > >>+ {} > >>+}; > >>+MODULE_DEVICE_TABLE(of, powerps_of_match); > >>+ > >>+static struct i2c_driver powerps_driver = { > >>+ .driver = { > >>+ .name = "powerps", > >>+ .of_match_table = powerps_of_match, > >>+ }, > >>+ .probe = powerps_probe, > >>+ .remove = pmbus_do_remove, > >>+ .id_table = powerps_id, > >>+}; > >>+ > >>+module_i2c_driver(powerps_driver); > >>+ > >>+MODULE_AUTHOR("Eddie James"); > >>+MODULE_DESCRIPTION("PMBus driver for POWER system power supplies"); > >>+MODULE_LICENSE("GPL"); > >>-- > >>1.8.3.1 > >> > ^ permalink raw reply [flat|nested] 10+ messages in thread
* [PATCH v2 3/3] Documentation: hwmon: Add POWER system power supply documentation 2017-08-10 22:19 [PATCH v2 0/3] hwmon: (pmbus): Add POWER System power supply driver Eddie James 2017-08-10 22:19 ` [PATCH v2 1/3] dt-bindings: i2c: Document the POWER system power supply device Eddie James 2017-08-10 22:19 ` [PATCH v2 2/3] hwmon: (pmbus): Add POWER system power supply driver Eddie James @ 2017-08-10 22:19 ` Eddie James 2017-08-11 1:19 ` Guenter Roeck 2 siblings, 1 reply; 10+ messages in thread From: Eddie James @ 2017-08-10 22:19 UTC (permalink / raw) To: linux Cc: robh+dt, jdelvare, linux-kernel, linux-hwmon, joel, jk, andrew, eajames, mark.rutland, devicetree, corbet, linux-doc, Edward A. James From: "Edward A. James" <eajames@us.ibm.com> Signed-off-by: Edward A. James <eajames@us.ibm.com> --- Documentation/hwmon/powerps | 54 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 Documentation/hwmon/powerps diff --git a/Documentation/hwmon/powerps b/Documentation/hwmon/powerps new file mode 100644 index 0000000..a4fbe92 --- /dev/null +++ b/Documentation/hwmon/powerps @@ -0,0 +1,54 @@ +Kernel driver powerps +===================== + +Supported chips: + * POWER system power supply + +Author: Eddie James <eajames@us.ibm.com> + +Description +----------- + +This driver supports POWER system power supplies. This driver is a client +to the core PMBus driver. + +Usage Notes +----------- + +This driver should auto-detect devices. In the event that it does not, you will +have to instantiate the devices explicitly. Please see +Documentation/i2c/instantiating-devices for details. + +Sysfs entries +------------- + +The following attributes are supported: + +curr1_alarm Output current over-current fault. +curr1_input Measured output current in mA. +curr1_label "iout1" + +fan1_alarm Fan 1 warning. +fan1_fault Fan 1 fault. +fan1_input Fan 1 speed in RPM. +fan2_alarm Fan 2 warning. +fan2_fault Fan 2 fault. +fan2_input Fan 2 speed in RPM. + +in1_alarm Input voltage under-voltage fault. +in1_input Measured input voltage in mV. +in1_label "vin" +in2_alarm Output voltage over-voltage fault. +in2_input Measured output voltage in mV. +in2_label "vout1" + +power1_alarm Input fault. +power1_input Measured input power in uW. +power1_label "pin" + +temp1_alarm PSU inlet ambient temperature over-temperature fault. +temp1_input Measured PSU inlet ambient temp in millidegrees C. +temp2_alarm Secondary rectifier temp over-temperature fault. +temp2_input Measured secondary rectifier temp in millidegrees C. +temp3_alarm ORing FET temperature over-temperature fault. +temp3_input Measured ORing FET temperature in millidegrees C. -- 1.8.3.1 ^ permalink raw reply related [flat|nested] 10+ messages in thread
* Re: [PATCH v2 3/3] Documentation: hwmon: Add POWER system power supply documentation 2017-08-10 22:19 ` [PATCH v2 3/3] Documentation: hwmon: Add POWER system power supply documentation Eddie James @ 2017-08-11 1:19 ` Guenter Roeck 0 siblings, 0 replies; 10+ messages in thread From: Guenter Roeck @ 2017-08-11 1:19 UTC (permalink / raw) To: Eddie James Cc: robh+dt, jdelvare, linux-kernel, linux-hwmon, joel, jk, andrew, mark.rutland, devicetree, corbet, linux-doc, Edward A. James On Thu, Aug 10, 2017 at 05:19:46PM -0500, Eddie James wrote: > From: "Edward A. James" <eajames@us.ibm.com> > > Signed-off-by: Edward A. James <eajames@us.ibm.com> > --- > Documentation/hwmon/powerps | 54 +++++++++++++++++++++++++++++++++++++++++++++ > 1 file changed, 54 insertions(+) > create mode 100644 Documentation/hwmon/powerps > > diff --git a/Documentation/hwmon/powerps b/Documentation/hwmon/powerps > new file mode 100644 > index 0000000..a4fbe92 > --- /dev/null > +++ b/Documentation/hwmon/powerps > @@ -0,0 +1,54 @@ > +Kernel driver powerps > +===================== > + > +Supported chips: > + * POWER system power supply > + > +Author: Eddie James <eajames@us.ibm.com> > + > +Description > +----------- > + > +This driver supports POWER system power supplies. This driver is a client > +to the core PMBus driver. > + > +Usage Notes > +----------- > + > +This driver should auto-detect devices. In the event that it does not, you will Not really, unless specified in devicetree or by other means in the kernel. But the _driver_ won't do it. pmbus drivers don't have detect functions. > +have to instantiate the devices explicitly. Please see > +Documentation/i2c/instantiating-devices for details. > + > +Sysfs entries > +------------- > + > +The following attributes are supported: > + > +curr1_alarm Output current over-current fault. > +curr1_input Measured output current in mA. > +curr1_label "iout1" > + > +fan1_alarm Fan 1 warning. > +fan1_fault Fan 1 fault. > +fan1_input Fan 1 speed in RPM. > +fan2_alarm Fan 2 warning. > +fan2_fault Fan 2 fault. > +fan2_input Fan 2 speed in RPM. > + > +in1_alarm Input voltage under-voltage fault. > +in1_input Measured input voltage in mV. > +in1_label "vin" > +in2_alarm Output voltage over-voltage fault. > +in2_input Measured output voltage in mV. > +in2_label "vout1" > + > +power1_alarm Input fault. > +power1_input Measured input power in uW. > +power1_label "pin" > + > +temp1_alarm PSU inlet ambient temperature over-temperature fault. > +temp1_input Measured PSU inlet ambient temp in millidegrees C. > +temp2_alarm Secondary rectifier temp over-temperature fault. > +temp2_input Measured secondary rectifier temp in millidegrees C. > +temp3_alarm ORing FET temperature over-temperature fault. > +temp3_input Measured ORing FET temperature in millidegrees C. > -- > 1.8.3.1 > ^ permalink raw reply [flat|nested] 10+ messages in thread
end of thread, other threads:[~2017-08-21 18:35 UTC | newest] Thread overview: 10+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2017-08-10 22:19 [PATCH v2 0/3] hwmon: (pmbus): Add POWER System power supply driver Eddie James 2017-08-10 22:19 ` [PATCH v2 1/3] dt-bindings: i2c: Document the POWER system power supply device Eddie James 2017-08-17 15:11 ` Rob Herring 2017-08-21 18:35 ` Eddie James 2017-08-10 22:19 ` [PATCH v2 2/3] hwmon: (pmbus): Add POWER system power supply driver Eddie James 2017-08-11 1:18 ` Guenter Roeck 2017-08-11 14:30 ` Eddie James 2017-08-11 18:27 ` Guenter Roeck 2017-08-10 22:19 ` [PATCH v2 3/3] Documentation: hwmon: Add POWER system power supply documentation Eddie James 2017-08-11 1:19 ` Guenter Roeck
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for NNTP newsgroup(s).