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

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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 <grantpeltier93@xxxxxxxxx>

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 <maxims@xxxxxxxxxx>
>        - Robert Lippert <rlippert@xxxxxxxxxx>
>        - Patrick Venture <venture@xxxxxxxxxx>
> +      - Grant Peltier <grant.peltier.jg@xxxxxxxxxxx>
>  
>  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
> +======================= ==========================================



[Index of Archives]     [LM Sensors]     [Linux Sound]     [ALSA Users]     [ALSA Devel]     [Linux Audio Users]     [Linux Media]     [Kernel]     [Gimp]     [Yosemite News]     [Linux Media]

  Powered by Linux