1.. SPDX-License-Identifier: GPL-2.0 2 3Kernel driver stpddc60 4====================== 5 6Supported chips: 7 8 * ST STPDDC60 9 10 Prefix: 'stpddc60', 'bmr481' 11 12 Addresses scanned: - 13 14 Datasheet: https://flexpowermodules.com/documents/fpm-techspec-bmr481 15 16Author: Erik Rosen <erik.rosen@metormote.com> 17 18 19Description 20----------- 21 22This driver supports hardware monitoring for ST STPDDC60 controller chip and 23compatible modules. 24 25The driver is a client driver to the core PMBus driver. Please see 26Documentation/hwmon/pmbus.rst and Documentation.hwmon/pmbus-core for details 27on PMBus client drivers. 28 29 30Usage Notes 31----------- 32 33This driver does not auto-detect devices. You will have to instantiate the 34devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for 35details. 36 37The vout under- and over-voltage limits are set in relation to the commanded 38output voltage as a positive or negative offset in the interval 50mV to 400mV 39in 50mV steps. This means that the absolute values of the limits will change 40when the commanded output voltage changes. Also, care should be taken when 41writing to those limits since in the worst case the commanded output voltage 42could change at the same time as the limit is written to, which will lead to 43unpredictable results. 44 45 46Platform data support 47--------------------- 48 49The driver supports standard PMBus driver platform data. 50 51 52Sysfs entries 53------------- 54 55The following attributes are supported. Vin, iout, pout and temp limits 56are read-write; all other attributes are read-only. 57 58======================= ======================================================== 59in1_label "vin" 60in1_input Measured input voltage. 61in1_lcrit Critical minimum input voltage. 62in1_crit Critical maximum input voltage. 63in1_lcrit_alarm Input voltage critical low alarm. 64in1_crit_alarm Input voltage critical high alarm. 65 66in2_label "vout1" 67in2_input Measured output voltage. 68in2_lcrit Critical minimum output voltage. 69in2_crit Critical maximum output voltage. 70in2_lcrit_alarm Critical output voltage critical low alarm. 71in2_crit_alarm Critical output voltage critical high alarm. 72 73curr1_label "iout1" 74curr1_input Measured output current. 75curr1_max Maximum output current. 76curr1_max_alarm Output current high alarm. 77curr1_crit Critical maximum output current. 78curr1_crit_alarm Output current critical high alarm. 79 80power1_label "pout1" 81power1_input Measured output power. 82power1_crit Critical maximum output power. 83power1_crit_alarm Output power critical high alarm. 84 85temp1_input Measured maximum temperature of all phases. 86temp1_max Maximum temperature limit. 87temp1_max_alarm High temperature alarm. 88temp1_crit Critical maximum temperature limit. 89temp1_crit_alarm Critical maximum temperature alarm. 90======================= ======================================================== 91