0001 Kernel driver zl6100
0002 ====================
0003
0004 Supported chips:
0005
0006 * Renesas / Intersil / Zilker Labs ZL2004
0007
0008 Prefix: 'zl2004'
0009
0010 Addresses scanned: -
0011
0012 Datasheet: https://www.renesas.com/us/en/document/dst/zl2004-datasheet.pdf
0013
0014 * Renesas / Intersil / Zilker Labs ZL2005
0015
0016 Prefix: 'zl2005'
0017
0018 Addresses scanned: -
0019
0020 Datasheet: https://www.renesas.com/us/en/document/dst/zl2005-datasheet.pdf
0021
0022 * Renesas / Intersil / Zilker Labs ZL2006
0023
0024 Prefix: 'zl2006'
0025
0026 Addresses scanned: -
0027
0028 Datasheet: https://www.renesas.com/us/en/document/dst/zl2006-datasheet.pdf
0029
0030 * Renesas / Intersil / Zilker Labs ZL2008
0031
0032 Prefix: 'zl2008'
0033
0034 Addresses scanned: -
0035
0036 Datasheet: https://www.renesas.com/us/en/document/dst/zl2008-datasheet.pdf
0037
0038 * Renesas / Intersil / Zilker Labs ZL2105
0039
0040 Prefix: 'zl2105'
0041
0042 Addresses scanned: -
0043
0044 Datasheet: https://www.renesas.com/us/en/document/dst/zl2105-datasheet.pdf
0045
0046 * Renesas / Intersil / Zilker Labs ZL2106
0047
0048 Prefix: 'zl2106'
0049
0050 Addresses scanned: -
0051
0052 Datasheet: https://www.renesas.com/us/en/document/dst/zl2106-datasheet.pdf
0053
0054 * Renesas / Intersil / Zilker Labs ZL6100
0055
0056 Prefix: 'zl6100'
0057
0058 Addresses scanned: -
0059
0060 Datasheet: https://www.renesas.com/us/en/document/dst/zl6100-datasheet.pdf
0061
0062 * Renesas / Intersil / Zilker Labs ZL6105
0063
0064 Prefix: 'zl6105'
0065
0066 Addresses scanned: -
0067
0068 Datasheet: https://www.renesas.com/us/en/document/dst/zl6105-datasheet.pdf
0069
0070 * Renesas / Intersil / Zilker Labs ZL8802
0071
0072 Prefix: 'zl8802'
0073
0074 Addresses scanned: -
0075
0076 Datasheet: https://www.renesas.com/us/en/document/dst/zl8802-datasheet
0077
0078 * Renesas / Intersil / Zilker Labs ZL9101M
0079
0080 Prefix: 'zl9101'
0081
0082 Addresses scanned: -
0083
0084 Datasheet: https://www.renesas.com/us/en/document/dst/zl9101m-datasheet
0085
0086 * Renesas / Intersil / Zilker Labs ZL9117M
0087
0088 Prefix: 'zl9117'
0089
0090 Addresses scanned: -
0091
0092 Datasheet: https://www.renesas.com/us/en/document/dst/zl9117m-datasheet
0093
0094 * Renesas / Intersil / Zilker Labs ZLS1003, ZLS4009
0095
0096 Prefix: 'zls1003', zls4009
0097
0098 Addresses scanned: -
0099
0100 Datasheet: Not published
0101
0102 * Flex BMR450, BMR451
0103
0104 Prefix: 'bmr450', 'bmr451'
0105
0106 Addresses scanned: -
0107
0108 Datasheet:
0109
0110 https://flexpowermodules.com/resources/fpm-techspec-bmr450-digital-pol-regulators-20a
0111
0112 * Flex BMR462, BMR463, BMR464
0113
0114 Prefixes: 'bmr462', 'bmr463', 'bmr464'
0115
0116 Addresses scanned: -
0117
0118 Datasheet: https://flexpowermodules.com/resources/fpm-techspec-bmr462
0119
0120 * Flex BMR465, BMR467
0121
0122 Prefixes: 'bmr465', 'bmr467'
0123
0124 Addresses scanned: -
0125
0126 Datasheet: https://flexpowermodules.com/resources/fpm-techspec-bmr465-digital-pol
0127
0128 * Flex BMR466
0129
0130 Prefixes: 'bmr466'
0131
0132 Addresses scanned: -
0133
0134 Datasheet: https://flexpowermodules.com/resources/fpm-techspec-bmr466-8x12
0135
0136 * Flex BMR469
0137
0138 Prefixes: 'bmr469'
0139
0140 Addresses scanned: -
0141
0142 Datasheet: https://flexpowermodules.com/resources/fpm-techspec-bmr4696001
0143
0144 Author: Guenter Roeck <linux@roeck-us.net>
0145
0146
0147 Description
0148 -----------
0149
0150 This driver supports hardware monitoring for Renesas / Intersil / Zilker Labs
0151 ZL6100 and compatible digital DC-DC controllers.
0152
0153 The driver is a client driver to the core PMBus driver. Please see
0154 Documentation/hwmon/pmbus.rst and Documentation.hwmon/pmbus-core for details
0155 on PMBus client drivers.
0156
0157
0158 Usage Notes
0159 -----------
0160
0161 This driver does not auto-detect devices. You will have to instantiate the
0162 devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
0163 details.
0164
0165 .. warning::
0166
0167 Do not access chip registers using the i2cdump command, and do not use
0168 any of the i2ctools commands on a command register used to save and restore
0169 configuration data (0x11, 0x12, 0x15, 0x16, and 0xf4). The chips supported by
0170 this driver interpret any access to those command registers (including read
0171 commands) as request to execute the command in question. Unless write accesses
0172 to those registers are protected, this may result in power loss, board resets,
0173 and/or Flash corruption. Worst case, your board may turn into a brick.
0174
0175
0176 Platform data support
0177 ---------------------
0178
0179 The driver supports standard PMBus driver platform data.
0180
0181
0182 Module parameters
0183 -----------------
0184
0185 delay
0186 -----
0187
0188 Renesas/Intersil/Zilker Labs DC-DC controllers require a minimum interval
0189 between I2C bus accesses. According to Intersil, the minimum interval is 2 ms,
0190 though 1 ms appears to be sufficient and has not caused any problems in testing.
0191 The problem is known to affect all currently supported chips. For manual override,
0192 the driver provides a writeable module parameter, 'delay', which can be used
0193 to set the interval to a value between 0 and 65,535 microseconds.
0194
0195
0196 Sysfs entries
0197 -------------
0198
0199 The following attributes are supported. Limits are read-write; all other
0200 attributes are read-only.
0201
0202 ======================= ========================================================
0203 in1_label "vin"
0204 in1_input Measured input voltage.
0205 in1_min Minimum input voltage.
0206 in1_max Maximum input voltage.
0207 in1_lcrit Critical minimum input voltage.
0208 in1_crit Critical maximum input voltage.
0209 in1_min_alarm Input voltage low alarm.
0210 in1_max_alarm Input voltage high alarm.
0211 in1_lcrit_alarm Input voltage critical low alarm.
0212 in1_crit_alarm Input voltage critical high alarm.
0213
0214 in2_label "vmon"
0215 in2_input Measured voltage on VMON (ZL2004) or VDRV (ZL9101M,
0216 ZL9117M) pin. Reported voltage is 16x the voltage on the
0217 pin (adjusted internally by the chip).
0218 in2_lcrit Critical minimum VMON/VDRV Voltage.
0219 in2_crit Critical maximum VMON/VDRV voltage.
0220 in2_lcrit_alarm VMON/VDRV voltage critical low alarm.
0221 in2_crit_alarm VMON/VDRV voltage critical high alarm.
0222
0223 vmon attributes are supported on ZL2004, ZL8802,
0224 ZL9101M, ZL9117M and ZLS4009 only.
0225
0226 inX_label "vout[12]"
0227 inX_input Measured output voltage.
0228 inX_lcrit Critical minimum output Voltage.
0229 inX_crit Critical maximum output voltage.
0230 inX_lcrit_alarm Critical output voltage critical low alarm.
0231 inX_crit_alarm Critical output voltage critical high alarm.
0232
0233 X is 3 for ZL2004, ZL9101M, and ZL9117M,
0234 3, 4 for ZL8802 and 2 otherwise.
0235
0236 curr1_label "iin"
0237 curr1_input Measured input current.
0238
0239 iin attributes are supported on ZL8802 only
0240
0241 currY_label "iout[12]"
0242 currY_input Measured output current.
0243 currY_lcrit Critical minimum output current.
0244 currY_crit Critical maximum output current.
0245 currY_lcrit_alarm Output current critical low alarm.
0246 currY_crit_alarm Output current critical high alarm.
0247
0248 Y is 2, 3 for ZL8802, 1 otherwise
0249
0250 temp[12]_input Measured temperature.
0251 temp[12]_min Minimum temperature.
0252 temp[12]_max Maximum temperature.
0253 temp[12]_lcrit Critical low temperature.
0254 temp[12]_crit Critical high temperature.
0255 temp[12]_min_alarm Chip temperature low alarm.
0256 temp[12]_max_alarm Chip temperature high alarm.
0257 temp[12]_lcrit_alarm Chip temperature critical low alarm.
0258 temp[12]_crit_alarm Chip temperature critical high alarm.
0259 ======================= ========================================================
