0001 .. SPDX-License-Identifier: GPL-2.0
0002
0003 Kernel driver stpddc60
0004 ======================
0005
0006 Supported chips:
0007
0008 * ST STPDDC60
0009
0010 Prefix: 'stpddc60', 'bmr481'
0011
0012 Addresses scanned: -
0013
0014 Datasheet: https://flexpowermodules.com/documents/fpm-techspec-bmr481
0015
0016 Author: Erik Rosen <erik.rosen@metormote.com>
0017
0018
0019 Description
0020 -----------
0021
0022 This driver supports hardware monitoring for ST STPDDC60 controller chip and
0023 compatible modules.
0024
0025 The driver is a client driver to the core PMBus driver. Please see
0026 Documentation/hwmon/pmbus.rst and Documentation.hwmon/pmbus-core for details
0027 on PMBus client drivers.
0028
0029
0030 Usage Notes
0031 -----------
0032
0033 This driver does not auto-detect devices. You will have to instantiate the
0034 devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
0035 details.
0036
0037 The vout under- and over-voltage limits are set in relation to the commanded
0038 output voltage as a positive or negative offset in the interval 50mV to 400mV
0039 in 50mV steps. This means that the absolute values of the limits will change
0040 when the commanded output voltage changes. Also, care should be taken when
0041 writing to those limits since in the worst case the commanded output voltage
0042 could change at the same time as the limit is written to, wich will lead to
0043 unpredictable results.
0044
0045
0046 Platform data support
0047 ---------------------
0048
0049 The driver supports standard PMBus driver platform data.
0050
0051
0052 Sysfs entries
0053 -------------
0054
0055 The following attributes are supported. Vin, iout, pout and temp limits
0056 are read-write; all other attributes are read-only.
0057
0058 ======================= ========================================================
0059 in1_label "vin"
0060 in1_input Measured input voltage.
0061 in1_lcrit Critical minimum input voltage.
0062 in1_crit Critical maximum input voltage.
0063 in1_lcrit_alarm Input voltage critical low alarm.
0064 in1_crit_alarm Input voltage critical high alarm.
0065
0066 in2_label "vout1"
0067 in2_input Measured output voltage.
0068 in2_lcrit Critical minimum output voltage.
0069 in2_crit Critical maximum output voltage.
0070 in2_lcrit_alarm Critical output voltage critical low alarm.
0071 in2_crit_alarm Critical output voltage critical high alarm.
0072
0073 curr1_label "iout1"
0074 curr1_input Measured output current.
0075 curr1_max Maximum output current.
0076 curr1_max_alarm Output current high alarm.
0077 curr1_crit Critical maximum output current.
0078 curr1_crit_alarm Output current critical high alarm.
0079
0080 power1_label "pout1"
0081 power1_input Measured output power.
0082 power1_crit Critical maximum output power.
0083 power1_crit_alarm Output power critical high alarm.
0084
0085 temp1_input Measured maximum temperature of all phases.
0086 temp1_max Maximum temperature limit.
0087 temp1_max_alarm High temperature alarm.
0088 temp1_crit Critical maximum temperature limit.
0089 temp1_crit_alarm Critical maximum temperature alarm.
0090 ======================= ========================================================
