260 lines · plain
1Kernel driver zl61002====================3 4Supported chips:5 6 * Renesas / Intersil / Zilker Labs ZL20047 8 Prefix: 'zl2004'9 10 Addresses scanned: -11 12 Datasheet: https://www.renesas.com/us/en/document/dst/zl2004-datasheet.pdf13 14 * Renesas / Intersil / Zilker Labs ZL200515 16 Prefix: 'zl2005'17 18 Addresses scanned: -19 20 Datasheet: https://www.renesas.com/us/en/document/dst/zl2005-datasheet.pdf21 22 * Renesas / Intersil / Zilker Labs ZL200623 24 Prefix: 'zl2006'25 26 Addresses scanned: -27 28 Datasheet: https://www.renesas.com/us/en/document/dst/zl2006-datasheet.pdf29 30 * Renesas / Intersil / Zilker Labs ZL200831 32 Prefix: 'zl2008'33 34 Addresses scanned: -35 36 Datasheet: https://www.renesas.com/us/en/document/dst/zl2008-datasheet.pdf37 38 * Renesas / Intersil / Zilker Labs ZL210539 40 Prefix: 'zl2105'41 42 Addresses scanned: -43 44 Datasheet: https://www.renesas.com/us/en/document/dst/zl2105-datasheet.pdf45 46 * Renesas / Intersil / Zilker Labs ZL210647 48 Prefix: 'zl2106'49 50 Addresses scanned: -51 52 Datasheet: https://www.renesas.com/us/en/document/dst/zl2106-datasheet.pdf53 54 * Renesas / Intersil / Zilker Labs ZL610055 56 Prefix: 'zl6100'57 58 Addresses scanned: -59 60 Datasheet: https://www.renesas.com/us/en/document/dst/zl6100-datasheet.pdf61 62 * Renesas / Intersil / Zilker Labs ZL610563 64 Prefix: 'zl6105'65 66 Addresses scanned: -67 68 Datasheet: https://www.renesas.com/us/en/document/dst/zl6105-datasheet.pdf69 70 * Renesas / Intersil / Zilker Labs ZL880271 72 Prefix: 'zl8802'73 74 Addresses scanned: -75 76 Datasheet: https://www.renesas.com/us/en/document/dst/zl8802-datasheet77 78 * Renesas / Intersil / Zilker Labs ZL9101M79 80 Prefix: 'zl9101'81 82 Addresses scanned: -83 84 Datasheet: https://www.renesas.com/us/en/document/dst/zl9101m-datasheet85 86 * Renesas / Intersil / Zilker Labs ZL9117M87 88 Prefix: 'zl9117'89 90 Addresses scanned: -91 92 Datasheet: https://www.renesas.com/us/en/document/dst/zl9117m-datasheet93 94 * Renesas / Intersil / Zilker Labs ZLS1003, ZLS400995 96 Prefix: 'zls1003', zls400997 98 Addresses scanned: -99 100 Datasheet: Not published101 102 * Flex BMR450, BMR451103 104 Prefix: 'bmr450', 'bmr451'105 106 Addresses scanned: -107 108 Datasheet:109 110https://flexpowermodules.com/resources/fpm-techspec-bmr450-digital-pol-regulators-20a111 112 * Flex BMR462, BMR463, BMR464113 114 Prefixes: 'bmr462', 'bmr463', 'bmr464'115 116 Addresses scanned: -117 118 Datasheet: https://flexpowermodules.com/resources/fpm-techspec-bmr462119 120 * Flex BMR465, BMR467121 122 Prefixes: 'bmr465', 'bmr467'123 124 Addresses scanned: -125 126 Datasheet: https://flexpowermodules.com/resources/fpm-techspec-bmr465-digital-pol127 128 * Flex BMR466129 130 Prefixes: 'bmr466'131 132 Addresses scanned: -133 134 Datasheet: https://flexpowermodules.com/resources/fpm-techspec-bmr466-8x12135 136 * Flex BMR469137 138 Prefixes: 'bmr469'139 140 Addresses scanned: -141 142 Datasheet: https://flexpowermodules.com/resources/fpm-techspec-bmr4696001143 144Author: Guenter Roeck <linux@roeck-us.net>145 146 147Description148-----------149 150This driver supports hardware monitoring for Renesas / Intersil / Zilker Labs151ZL6100 and compatible digital DC-DC controllers.152 153The driver is a client driver to the core PMBus driver. Please see154Documentation/hwmon/pmbus.rst and Documentation.hwmon/pmbus-core for details155on PMBus client drivers.156 157 158Usage Notes159-----------160 161This driver does not auto-detect devices. You will have to instantiate the162devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for163details.164 165.. warning::166 167 Do not access chip registers using the i2cdump command, and do not use168 any of the i2ctools commands on a command register used to save and restore169 configuration data (0x11, 0x12, 0x15, 0x16, and 0xf4). The chips supported by170 this driver interpret any access to those command registers (including read171 commands) as request to execute the command in question. Unless write accesses172 to those registers are protected, this may result in power loss, board resets,173 and/or Flash corruption. Worst case, your board may turn into a brick.174 175 176Platform data support177---------------------178 179The driver supports standard PMBus driver platform data.180 181 182Module parameters183-----------------184 185delay186-----187 188Renesas/Intersil/Zilker Labs DC-DC controllers require a minimum interval189between I2C bus accesses. According to Intersil, the minimum interval is 2 ms,190though 1 ms appears to be sufficient and has not caused any problems in testing.191The problem is known to affect all currently supported chips. For manual override,192the driver provides a writeable module parameter, 'delay', which can be used193to set the interval to a value between 0 and 65,535 microseconds.194 195 196Sysfs entries197-------------198 199The following attributes are supported. Limits are read-write; all other200attributes are read-only.201 202======================= ========================================================203in1_label "vin"204in1_input Measured input voltage.205in1_min Minimum input voltage.206in1_max Maximum input voltage.207in1_lcrit Critical minimum input voltage.208in1_crit Critical maximum input voltage.209in1_min_alarm Input voltage low alarm.210in1_max_alarm Input voltage high alarm.211in1_lcrit_alarm Input voltage critical low alarm.212in1_crit_alarm Input voltage critical high alarm.213 214in2_label "vmon"215in2_input Measured voltage on VMON (ZL2004) or VDRV (ZL9101M,216 ZL9117M) pin. Reported voltage is 16x the voltage on the217 pin (adjusted internally by the chip).218in2_lcrit Critical minimum VMON/VDRV Voltage.219in2_crit Critical maximum VMON/VDRV voltage.220in2_lcrit_alarm VMON/VDRV voltage critical low alarm.221in2_crit_alarm VMON/VDRV voltage critical high alarm.222 223 vmon attributes are supported on ZL2004, ZL8802,224 ZL9101M, ZL9117M and ZLS4009 only.225 226inX_label "vout[12]"227inX_input Measured output voltage.228inX_lcrit Critical minimum output Voltage.229inX_crit Critical maximum output voltage.230inX_lcrit_alarm Critical output voltage critical low alarm.231inX_crit_alarm Critical output voltage critical high alarm.232 233 X is 3 for ZL2004, ZL9101M, and ZL9117M,234 3, 4 for ZL8802 and 2 otherwise.235 236curr1_label "iin"237curr1_input Measured input current.238 239 iin attributes are supported on ZL8802 only240 241currY_label "iout[12]"242currY_input Measured output current.243currY_lcrit Critical minimum output current.244currY_crit Critical maximum output current.245currY_lcrit_alarm Output current critical low alarm.246currY_crit_alarm Output current critical high alarm.247 248 Y is 2, 3 for ZL8802, 1 otherwise249 250temp[12]_input Measured temperature.251temp[12]_min Minimum temperature.252temp[12]_max Maximum temperature.253temp[12]_lcrit Critical low temperature.254temp[12]_crit Critical high temperature.255temp[12]_min_alarm Chip temperature low alarm.256temp[12]_max_alarm Chip temperature high alarm.257temp[12]_lcrit_alarm Chip temperature critical low alarm.258temp[12]_crit_alarm Chip temperature critical high alarm.259======================= ========================================================260