2020-03-20 16:17:45

by Grant Peltier

[permalink] [raw]
Subject: [PATCH v3 2/2] docs: hwmon: Update documentation for isl68137 pmbus driver

Update documentation to include reference information for newly
supported 2nd generation Renesas digital multiphase voltage regulators.
Also update branding from Intersil to Renesas.

Signed-off-by: Grant Peltier <[email protected]>
---
Documentation/hwmon/isl68137.rst | 541 ++++++++++++++++++++++++++++++-
1 file changed, 533 insertions(+), 8 deletions(-)

diff --git a/Documentation/hwmon/isl68137.rst b/Documentation/hwmon/isl68137.rst
index a5a7c8545c9e..cc4b61447b63 100644
--- a/Documentation/hwmon/isl68137.rst
+++ b/Documentation/hwmon/isl68137.rst
@@ -3,7 +3,7 @@ Kernel driver isl68137

Supported chips:

- * Intersil ISL68137
+ * Renesas ISL68137

Prefix: 'isl68137'

@@ -11,19 +11,405 @@ Supported chips:

Datasheet:

- Publicly available at the Intersil website
- https://www.intersil.com/content/dam/Intersil/documents/isl6/isl68137.pdf
+ Publicly available at the Renesas website
+ https://www.renesas.com/us/en/www/doc/datasheet/isl68137.pdf
+
+ * Renesas ISL68220
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL68221
+
+ Prefix: 'raa_dmpvr2_3rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL68222
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL68223
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL68224
+
+ Prefix: 'raa_dmpvr2_3rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL68225
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL68226
+
+ Prefix: 'raa_dmpvr2_3rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL68227
+
+ Prefix: 'raa_dmpvr2_1rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL68229
+
+ Prefix: 'raa_dmpvr2_3rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL68233
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL68239
+
+ Prefix: 'raa_dmpvr2_3rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69222
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69223
+
+ Prefix: 'raa_dmpvr2_3rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69224
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69225
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69227
+
+ Prefix: 'raa_dmpvr2_3rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69228
+
+ Prefix: 'raa_dmpvr2_3rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69234
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69236
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69239
+
+ Prefix: 'raa_dmpvr2_3rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69242
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69243
+
+ Prefix: 'raa_dmpvr2_1rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69247
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69248
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69254
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69255
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69256
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69259
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69260
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69268
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69269
+
+ Prefix: 'raa_dmpvr2_3rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas ISL69298
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas RAA228000
+
+ Prefix: 'raa_dmpvr2_hv'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas RAA228004
+
+ Prefix: 'raa_dmpvr2_hv'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas RAA228006
+
+ Prefix: 'raa_dmpvr2_hv'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas RAA228228
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas RAA229001
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website
+
+ * Renesas RAA229004
+
+ Prefix: 'raa_dmpvr2_2rail'
+
+ Addresses scanned: -
+
+ Datasheet:
+
+ Publicly available (after August 2020 launch) at the Renesas website

Authors:
- Maxim Sloyko <[email protected]>
- Robert Lippert <[email protected]>
- Patrick Venture <[email protected]>
+ - Grant Peltier <[email protected]>

Description
-----------

-Intersil ISL68137 is a digital output 7-phase configurable PWM
-controller with an AVSBus interface.
+This driver supports the Renesas ISL68137 and all 2nd generation Renesas
+digital multiphase voltage regulators (raa_dmpvr2). The ISL68137 is a digital
+output 7-phase configurable PWM controller with an AVSBus interface. 2nd
+generation devices are grouped into 4 distinct configurations: '1rail' for
+single-rail devices, '2rail' for dual-rail devices, '3rail' for 3-rail devices,
+and 'hv' for high voltage single-rail devices. Consult the individual datasheets
+for more information.

Usage Notes
-----------
@@ -33,10 +419,14 @@ devices explicitly.

The ISL68137 AVS operation mode must be enabled/disabled at runtime.

-Beyond the normal sysfs pmbus attributes, the driver exposes a control attribute.
+Beyond the normal sysfs pmbus attributes, the driver exposes a control attribute
+for the ISL68137.
+
+For 2nd generation Renesas digital multiphase voltage regulators, only the
+normal sysfs pmbus attributes are supported.

-Additional Sysfs attributes
----------------------------
+ISL68137 sysfs attributes
+-------------------------

======================= ====================================
avs(0|1)_enable Controls the AVS state of each rail.
@@ -78,3 +468,138 @@ temp[1-3]_crit_alarm Chip temperature critical high alarm
temp[1-3]_max Maximum temperature
temp[1-3]_max_alarm Chip temperature high alarm
======================= ====================================
+
+raa_dmpvr2_1rail/hv sysfs attributes
+------------------------------------
+
+======================= ==========================================
+curr1_label "iin"
+curr1_input Measured input current
+curr1_crit Critical maximum current
+curr1_crit_alarm Current critical high alarm
+
+curr2_label "iout"
+curr2_input Measured output current
+curr2_crit Critical maximum current
+curr2_crit_alarm Current critical high alarm
+
+in1_label "vin"
+in1_input Measured input voltage
+in1_lcrit Critical minimum input voltage
+in1_lcrit_alarm Input voltage critical low alarm
+in1_crit Critical maximum input voltage
+in1_crit_alarm Input voltage critical high alarm
+
+in2_label "vmon"
+in2_input Scaled VMON voltage read from the VMON pin
+
+in3_label "vout"
+in3_input Measured output voltage
+in3_lcrit Critical minimum output voltage
+in3_lcrit_alarm Output voltage critical low alarm
+in3_crit Critical maximum output voltage
+in3_crit_alarm Output voltage critical high alarm
+
+power1_label "pin"
+power1_input Measured input power
+power1_alarm Input power high alarm
+
+power2_label "pout"
+power2_input Measured output power
+
+temp[1-3]_input Measured temperature
+temp[1-3]_crit Critical high temperature
+temp[1-3]_crit_alarm Chip temperature critical high alarm
+temp[1-3]_max Maximum temperature
+temp[1-3]_max_alarm Chip temperature high alarm
+======================= ==========================================
+
+raa_dmpvr2_2rail sysfs attributes
+---------------------------------
+
+======================= ==========================================
+curr[1-2]_label "iin[1-2]"
+curr[1-2]_input Measured input current
+curr[1-2]_crit Critical maximum current
+curr[1-2]_crit_alarm Current critical high alarm
+
+curr[3-4]_label "iout[1-2]"
+curr[3-4]_input Measured output current
+curr[3-4]_crit Critical maximum current
+curr[3-4]_crit_alarm Current critical high alarm
+
+in1_label "vin"
+in1_input Measured input voltage
+in1_lcrit Critical minimum input voltage
+in1_lcrit_alarm Input voltage critical low alarm
+in1_crit Critical maximum input voltage
+in1_crit_alarm Input voltage critical high alarm
+
+in2_label "vmon"
+in2_input Scaled VMON voltage read from the VMON pin
+
+in[3-4]_label "vout[1-2]"
+in[3-4]_input Measured output voltage
+in[3-4]_lcrit Critical minimum output voltage
+in[3-4]_lcrit_alarm Output voltage critical low alarm
+in[3-4]_crit Critical maximum output voltage
+in[3-4]_crit_alarm Output voltage critical high alarm
+
+power[1-2]_label "pin[1-2]"
+power[1-2]_input Measured input power
+power[1-2]_alarm Input power high alarm
+
+power[3-4]_label "pout[1-2]"
+power[3-4]_input Measured output power
+
+temp[1-5]_input Measured temperature
+temp[1-5]_crit Critical high temperature
+temp[1-5]_crit_alarm Chip temperature critical high alarm
+temp[1-5]_max Maximum temperature
+temp[1-5]_max_alarm Chip temperature high alarm
+======================= ==========================================
+
+raa_dmpvr2_3rail sysfs attributes
+---------------------------------
+
+======================= ==========================================
+curr[1-3]_label "iin[1-3]"
+curr[1-3]_input Measured input current
+curr[1-3]_crit Critical maximum current
+curr[1-3]_crit_alarm Current critical high alarm
+
+curr[4-6]_label "iout[1-3]"
+curr[4-6]_input Measured output current
+curr[4-6]_crit Critical maximum current
+curr[4-6]_crit_alarm Current critical high alarm
+
+in1_label "vin"
+in1_input Measured input voltage
+in1_lcrit Critical minimum input voltage
+in1_lcrit_alarm Input voltage critical low alarm
+in1_crit Critical maximum input voltage
+in1_crit_alarm Input voltage critical high alarm
+
+in2_label "vmon"
+in2_input Scaled VMON voltage read from the VMON pin
+
+in[3-5]_label "vout[1-3]"
+in[3-5]_input Measured output voltage
+in[3-5]_lcrit Critical minimum output voltage
+in[3-5]_lcrit_alarm Output voltage critical low alarm
+in[3-5]_crit Critical maximum output voltage
+in[3-5]_crit_alarm Output voltage critical high alarm
+
+power[1-3]_label "pin[1-3]"
+power[1-3]_input Measured input power
+power[1-3]_alarm Input power high alarm
+
+power[4-6]_label "pout[1-3]"
+power[4-6]_input Measured output power
+
+temp[1-7]_input Measured temperature
+temp[1-7]_crit Critical high temperature
+temp[1-7]_crit_alarm Chip temperature critical high alarm
+temp[1-7]_max Maximum temperature
+temp[1-7]_max_alarm Chip temperature high alarm
+======================= ==========================================
--
2.20.1


2020-03-21 22:11:08

by Guenter Roeck

[permalink] [raw]
Subject: Re: [PATCH v3 2/2] docs: hwmon: Update documentation for isl68137 pmbus driver

On Fri, Mar 20, 2020 at 11:16:47AM -0500, Grant Peltier wrote:
> Update documentation to include reference information for newly
> supported 2nd generation Renesas digital multiphase voltage regulators.
> Also update branding from Intersil to Renesas.
>
> Signed-off-by: Grant Peltier <[email protected]>

Applied.

Thanks,
Guenter

> ---
> Documentation/hwmon/isl68137.rst | 541 ++++++++++++++++++++++++++++++-
> 1 file changed, 533 insertions(+), 8 deletions(-)
>
> diff --git a/Documentation/hwmon/isl68137.rst b/Documentation/hwmon/isl68137.rst
> index a5a7c8545c9e..cc4b61447b63 100644
> --- a/Documentation/hwmon/isl68137.rst
> +++ b/Documentation/hwmon/isl68137.rst
> @@ -3,7 +3,7 @@ Kernel driver isl68137
>
> Supported chips:
>
> - * Intersil ISL68137
> + * Renesas ISL68137
>
> Prefix: 'isl68137'
>
> @@ -11,19 +11,405 @@ Supported chips:
>
> Datasheet:
>
> - Publicly available at the Intersil website
> - https://www.intersil.com/content/dam/Intersil/documents/isl6/isl68137.pdf
> + Publicly available at the Renesas website
> + https://www.renesas.com/us/en/www/doc/datasheet/isl68137.pdf
> +
> + * Renesas ISL68220
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL68221
> +
> + Prefix: 'raa_dmpvr2_3rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL68222
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL68223
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL68224
> +
> + Prefix: 'raa_dmpvr2_3rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL68225
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL68226
> +
> + Prefix: 'raa_dmpvr2_3rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL68227
> +
> + Prefix: 'raa_dmpvr2_1rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL68229
> +
> + Prefix: 'raa_dmpvr2_3rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL68233
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL68239
> +
> + Prefix: 'raa_dmpvr2_3rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69222
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69223
> +
> + Prefix: 'raa_dmpvr2_3rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69224
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69225
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69227
> +
> + Prefix: 'raa_dmpvr2_3rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69228
> +
> + Prefix: 'raa_dmpvr2_3rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69234
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69236
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69239
> +
> + Prefix: 'raa_dmpvr2_3rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69242
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69243
> +
> + Prefix: 'raa_dmpvr2_1rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69247
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69248
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69254
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69255
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69256
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69259
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69260
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69268
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69269
> +
> + Prefix: 'raa_dmpvr2_3rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas ISL69298
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas RAA228000
> +
> + Prefix: 'raa_dmpvr2_hv'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas RAA228004
> +
> + Prefix: 'raa_dmpvr2_hv'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas RAA228006
> +
> + Prefix: 'raa_dmpvr2_hv'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas RAA228228
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas RAA229001
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
> +
> + * Renesas RAA229004
> +
> + Prefix: 'raa_dmpvr2_2rail'
> +
> + Addresses scanned: -
> +
> + Datasheet:
> +
> + Publicly available (after August 2020 launch) at the Renesas website
>
> Authors:
> - Maxim Sloyko <[email protected]>
> - Robert Lippert <[email protected]>
> - Patrick Venture <[email protected]>
> + - Grant Peltier <[email protected]>
>
> Description
> -----------
>
> -Intersil ISL68137 is a digital output 7-phase configurable PWM
> -controller with an AVSBus interface.
> +This driver supports the Renesas ISL68137 and all 2nd generation Renesas
> +digital multiphase voltage regulators (raa_dmpvr2). The ISL68137 is a digital
> +output 7-phase configurable PWM controller with an AVSBus interface. 2nd
> +generation devices are grouped into 4 distinct configurations: '1rail' for
> +single-rail devices, '2rail' for dual-rail devices, '3rail' for 3-rail devices,
> +and 'hv' for high voltage single-rail devices. Consult the individual datasheets
> +for more information.
>
> Usage Notes
> -----------
> @@ -33,10 +419,14 @@ devices explicitly.
>
> The ISL68137 AVS operation mode must be enabled/disabled at runtime.
>
> -Beyond the normal sysfs pmbus attributes, the driver exposes a control attribute.
> +Beyond the normal sysfs pmbus attributes, the driver exposes a control attribute
> +for the ISL68137.
> +
> +For 2nd generation Renesas digital multiphase voltage regulators, only the
> +normal sysfs pmbus attributes are supported.
>
> -Additional Sysfs attributes
> ----------------------------
> +ISL68137 sysfs attributes
> +-------------------------
>
> ======================= ====================================
> avs(0|1)_enable Controls the AVS state of each rail.
> @@ -78,3 +468,138 @@ temp[1-3]_crit_alarm Chip temperature critical high alarm
> temp[1-3]_max Maximum temperature
> temp[1-3]_max_alarm Chip temperature high alarm
> ======================= ====================================
> +
> +raa_dmpvr2_1rail/hv sysfs attributes
> +------------------------------------
> +
> +======================= ==========================================
> +curr1_label "iin"
> +curr1_input Measured input current
> +curr1_crit Critical maximum current
> +curr1_crit_alarm Current critical high alarm
> +
> +curr2_label "iout"
> +curr2_input Measured output current
> +curr2_crit Critical maximum current
> +curr2_crit_alarm Current critical high alarm
> +
> +in1_label "vin"
> +in1_input Measured input voltage
> +in1_lcrit Critical minimum input voltage
> +in1_lcrit_alarm Input voltage critical low alarm
> +in1_crit Critical maximum input voltage
> +in1_crit_alarm Input voltage critical high alarm
> +
> +in2_label "vmon"
> +in2_input Scaled VMON voltage read from the VMON pin
> +
> +in3_label "vout"
> +in3_input Measured output voltage
> +in3_lcrit Critical minimum output voltage
> +in3_lcrit_alarm Output voltage critical low alarm
> +in3_crit Critical maximum output voltage
> +in3_crit_alarm Output voltage critical high alarm
> +
> +power1_label "pin"
> +power1_input Measured input power
> +power1_alarm Input power high alarm
> +
> +power2_label "pout"
> +power2_input Measured output power
> +
> +temp[1-3]_input Measured temperature
> +temp[1-3]_crit Critical high temperature
> +temp[1-3]_crit_alarm Chip temperature critical high alarm
> +temp[1-3]_max Maximum temperature
> +temp[1-3]_max_alarm Chip temperature high alarm
> +======================= ==========================================
> +
> +raa_dmpvr2_2rail sysfs attributes
> +---------------------------------
> +
> +======================= ==========================================
> +curr[1-2]_label "iin[1-2]"
> +curr[1-2]_input Measured input current
> +curr[1-2]_crit Critical maximum current
> +curr[1-2]_crit_alarm Current critical high alarm
> +
> +curr[3-4]_label "iout[1-2]"
> +curr[3-4]_input Measured output current
> +curr[3-4]_crit Critical maximum current
> +curr[3-4]_crit_alarm Current critical high alarm
> +
> +in1_label "vin"
> +in1_input Measured input voltage
> +in1_lcrit Critical minimum input voltage
> +in1_lcrit_alarm Input voltage critical low alarm
> +in1_crit Critical maximum input voltage
> +in1_crit_alarm Input voltage critical high alarm
> +
> +in2_label "vmon"
> +in2_input Scaled VMON voltage read from the VMON pin
> +
> +in[3-4]_label "vout[1-2]"
> +in[3-4]_input Measured output voltage
> +in[3-4]_lcrit Critical minimum output voltage
> +in[3-4]_lcrit_alarm Output voltage critical low alarm
> +in[3-4]_crit Critical maximum output voltage
> +in[3-4]_crit_alarm Output voltage critical high alarm
> +
> +power[1-2]_label "pin[1-2]"
> +power[1-2]_input Measured input power
> +power[1-2]_alarm Input power high alarm
> +
> +power[3-4]_label "pout[1-2]"
> +power[3-4]_input Measured output power
> +
> +temp[1-5]_input Measured temperature
> +temp[1-5]_crit Critical high temperature
> +temp[1-5]_crit_alarm Chip temperature critical high alarm
> +temp[1-5]_max Maximum temperature
> +temp[1-5]_max_alarm Chip temperature high alarm
> +======================= ==========================================
> +
> +raa_dmpvr2_3rail sysfs attributes
> +---------------------------------
> +
> +======================= ==========================================
> +curr[1-3]_label "iin[1-3]"
> +curr[1-3]_input Measured input current
> +curr[1-3]_crit Critical maximum current
> +curr[1-3]_crit_alarm Current critical high alarm
> +
> +curr[4-6]_label "iout[1-3]"
> +curr[4-6]_input Measured output current
> +curr[4-6]_crit Critical maximum current
> +curr[4-6]_crit_alarm Current critical high alarm
> +
> +in1_label "vin"
> +in1_input Measured input voltage
> +in1_lcrit Critical minimum input voltage
> +in1_lcrit_alarm Input voltage critical low alarm
> +in1_crit Critical maximum input voltage
> +in1_crit_alarm Input voltage critical high alarm
> +
> +in2_label "vmon"
> +in2_input Scaled VMON voltage read from the VMON pin
> +
> +in[3-5]_label "vout[1-3]"
> +in[3-5]_input Measured output voltage
> +in[3-5]_lcrit Critical minimum output voltage
> +in[3-5]_lcrit_alarm Output voltage critical low alarm
> +in[3-5]_crit Critical maximum output voltage
> +in[3-5]_crit_alarm Output voltage critical high alarm
> +
> +power[1-3]_label "pin[1-3]"
> +power[1-3]_input Measured input power
> +power[1-3]_alarm Input power high alarm
> +
> +power[4-6]_label "pout[1-3]"
> +power[4-6]_input Measured output power
> +
> +temp[1-7]_input Measured temperature
> +temp[1-7]_crit Critical high temperature
> +temp[1-7]_crit_alarm Chip temperature critical high alarm
> +temp[1-7]_max Maximum temperature
> +temp[1-7]_max_alarm Chip temperature high alarm
> +======================= ==========================================