blob: a2098eb2409048bcade01e31976516aadc94323d [file] [log] [blame]
Guenter Roeck58615a92013-02-09 15:15:52 -08001Kernel driver lm25066
Guenter Roeck03e9bd82011-07-08 10:43:57 -07002=====================
3
4Supported chips:
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -03005
Guenter Roeck58615a92013-02-09 15:15:52 -08006 * TI LM25056
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -03007
Guenter Roeck58615a92013-02-09 15:15:52 -08008 Prefix: 'lm25056'
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -03009
Guenter Roeck58615a92013-02-09 15:15:52 -080010 Addresses scanned: -
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030011
Guenter Roeck58615a92013-02-09 15:15:52 -080012 Datasheets:
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030013
Alexander A. Klimovf12d6342020-07-19 19:04:20 +020014 https://www.ti.com/lit/gpn/lm25056
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030015
Alexander A. Klimovf12d6342020-07-19 19:04:20 +020016 https://www.ti.com/lit/gpn/lm25056a
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030017
Guenter Roeck03e9bd82011-07-08 10:43:57 -070018 * National Semiconductor LM25066
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030019
Guenter Roeck03e9bd82011-07-08 10:43:57 -070020 Prefix: 'lm25066'
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030021
Guenter Roeck03e9bd82011-07-08 10:43:57 -070022 Addresses scanned: -
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030023
Guenter Roeck03e9bd82011-07-08 10:43:57 -070024 Datasheets:
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030025
Guenter Roeck03e9bd82011-07-08 10:43:57 -070026 http://www.national.com/pf/LM/LM25066.html
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030027
Guenter Roeck03e9bd82011-07-08 10:43:57 -070028 http://www.national.com/pf/LM/LM25066A.html
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030029
Guenter Roeck03e9bd82011-07-08 10:43:57 -070030 * National Semiconductor LM5064
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030031
Guenter Roeck03e9bd82011-07-08 10:43:57 -070032 Prefix: 'lm5064'
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030033
Guenter Roeck03e9bd82011-07-08 10:43:57 -070034 Addresses scanned: -
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030035
Guenter Roeck03e9bd82011-07-08 10:43:57 -070036 Datasheet:
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030037
Guenter Roeck03e9bd82011-07-08 10:43:57 -070038 http://www.national.com/pf/LM/LM5064.html
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030039
Guenter Roeck03e9bd82011-07-08 10:43:57 -070040 * National Semiconductor LM5066
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030041
Guenter Roeck03e9bd82011-07-08 10:43:57 -070042 Prefix: 'lm5066'
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030043
Guenter Roeck03e9bd82011-07-08 10:43:57 -070044 Addresses scanned: -
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030045
Guenter Roeck03e9bd82011-07-08 10:43:57 -070046 Datasheet:
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030047
Guenter Roeck03e9bd82011-07-08 10:43:57 -070048 http://www.national.com/pf/LM/LM5066.html
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030049
Xo Wang5783ec22017-08-29 14:21:17 -070050 * Texas Instruments LM5066I
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030051
Xo Wang5783ec22017-08-29 14:21:17 -070052 Prefix: 'lm5066i'
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030053
Xo Wang5783ec22017-08-29 14:21:17 -070054 Addresses scanned: -
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030055
Xo Wang5783ec22017-08-29 14:21:17 -070056 Datasheet:
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030057
Alexander A. Klimovf12d6342020-07-19 19:04:20 +020058 https://www.ti.com/product/LM5066I
Guenter Roeck03e9bd82011-07-08 10:43:57 -070059
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030060
Guenter Roecke3333e52013-02-20 20:58:42 -080061Author: Guenter Roeck <linux@roeck-us.net>
Guenter Roeck03e9bd82011-07-08 10:43:57 -070062
63
64Description
65-----------
66
Masanari Iida92417da2016-02-28 12:57:57 +090067This driver supports hardware monitoring for National Semiconductor / TI LM25056,
Guenter Roeck666c1492017-11-28 18:33:06 -080068LM25066, LM5064, and LM5066/LM5066I Power Management, Monitoring,
Xo Wang5783ec22017-08-29 14:21:17 -070069Control, and Protection ICs.
Guenter Roeck03e9bd82011-07-08 10:43:57 -070070
71The driver is a client driver to the core PMBus driver. Please see
Mauro Carvalho Chehab7ebd8b662019-04-17 06:46:29 -030072Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
Guenter Roeck03e9bd82011-07-08 10:43:57 -070073
74
75Usage Notes
76-----------
77
78This driver does not auto-detect devices. You will have to instantiate the
Mauro Carvalho Chehabccf988b2019-07-26 09:51:16 -030079devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
Guenter Roeck03e9bd82011-07-08 10:43:57 -070080details.
81
Zev Weiss94ee5fc2021-09-28 02:22:41 -070082The shunt (sense) resistor value can be configured by a device tree property;
83see Documentation/devicetree/bindings/hwmon/pmbus/ti,lm25066.yaml for details.
Guenter Roeck03e9bd82011-07-08 10:43:57 -070084
85Platform data support
86---------------------
87
88The driver supports standard PMBus driver platform data.
89
90
91Sysfs entries
92-------------
93
94The following attributes are supported. Limits are read-write; all other
95attributes are read-only.
96
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -030097======================= =======================================================
Guenter Roeck03e9bd82011-07-08 10:43:57 -070098in1_label "vin"
99in1_input Measured input voltage.
100in1_average Average measured input voltage.
101in1_min Minimum input voltage.
102in1_max Maximum input voltage.
103in1_min_alarm Input voltage low alarm.
104in1_max_alarm Input voltage high alarm.
105
Guenter Roecka7c69112013-02-06 09:55:37 -0800106in2_label "vmon"
107in2_input Measured voltage on VAUX pin
Guenter Roeck58615a92013-02-09 15:15:52 -0800108in2_min Minimum VAUX voltage (LM25056 only).
109in2_max Maximum VAUX voltage (LM25056 only).
110in2_min_alarm VAUX voltage low alarm (LM25056 only).
111in2_max_alarm VAUX voltage high alarm (LM25056 only).
Guenter Roeck03e9bd82011-07-08 10:43:57 -0700112
Guenter Roecka7c69112013-02-06 09:55:37 -0800113in3_label "vout1"
Guenter Roeck58615a92013-02-09 15:15:52 -0800114 Not supported on LM25056.
Guenter Roecka7c69112013-02-06 09:55:37 -0800115in3_input Measured output voltage.
116in3_average Average measured output voltage.
117in3_min Minimum output voltage.
118in3_min_alarm Output voltage low alarm.
Guenter Roeck03e9bd82011-07-08 10:43:57 -0700119
120curr1_label "iin"
121curr1_input Measured input current.
122curr1_average Average measured input current.
123curr1_max Maximum input current.
124curr1_max_alarm Input current high alarm.
125
126power1_label "pin"
127power1_input Measured input power.
128power1_average Average measured input power.
129power1_max Maximum input power limit.
130power1_alarm Input power alarm
131power1_input_highest Historical maximum power.
132power1_reset_history Write any value to reset maximum power history.
133
Guenter Roeck03e9bd82011-07-08 10:43:57 -0700134temp1_input Measured temperature.
135temp1_max Maximum temperature.
136temp1_crit Critical high temperature.
137temp1_max_alarm Chip temperature high alarm.
138temp1_crit_alarm Chip temperature critical high alarm.
Mauro Carvalho Chehab1f234ff2019-04-17 06:46:26 -0300139======================= =======================================================