blob: 262e713e60ffffd1469091a28bd04a05280a1a6b [file] [log] [blame]
Guenter Roeck0c0a0612011-03-08 22:01:39 -08001Kernel driver ucd9000
2=====================
3
4Supported chips:
Matt Weber50b2b022016-08-19 21:08:45 -05005 * TI UCD90120, UCD90124, UCD90160, UCD9090, and UCD90910
6 Prefixes: 'ucd90120', 'ucd90124', 'ucd90160', 'ucd9090', 'ucd90910'
Guenter Roeck0c0a0612011-03-08 22:01:39 -08007 Addresses scanned: -
8 Datasheets:
9 http://focus.ti.com/lit/ds/symlink/ucd90120.pdf
10 http://focus.ti.com/lit/ds/symlink/ucd90124.pdf
Matt Weber50b2b022016-08-19 21:08:45 -050011 http://focus.ti.com/lit/ds/symlink/ucd90160.pdf
Guenter Roeck0c0a0612011-03-08 22:01:39 -080012 http://focus.ti.com/lit/ds/symlink/ucd9090.pdf
13 http://focus.ti.com/lit/ds/symlink/ucd90910.pdf
14
Guenter Roecke3333e52013-02-20 20:58:42 -080015Author: Guenter Roeck <linux@roeck-us.net>
Guenter Roeck0c0a0612011-03-08 22:01:39 -080016
17
18Description
19-----------
20
21From datasheets:
22
23The UCD90120 Power Supply Sequencer and System Health Monitor monitors and
24sequences up to 12 independent voltage rails. The device integrates a 12-bit
25ADC with a 2.5V internal reference for monitoring up to 13 power supply voltage,
26current, or temperature inputs.
27
28The UCD90124 is a 12-rail PMBus/I2C addressable power-supply sequencer and
29system-health monitor. The device integrates a 12-bit ADC for monitoring up to
3013 power-supply voltage, current, or temperature inputs. Twenty-six GPIO pins
31can be used for power supply enables, power-on reset signals, external
32interrupts, cascading, or other system functions. Twelve of these pins offer PWM
33functionality. Using these pins, the UCD90124 offers support for fan control,
34margining, and general-purpose PWM functions.
35
Matt Weber50b2b022016-08-19 21:08:45 -050036The UCD90160 is a 16-rail PMBus/I2C addressable power-supply sequencer and
37monitor. The device integrates a 12-bit ADC for monitoring up to 16 power-supply
38voltage inputs. Twenty-six GPIO pins can be used for power supply enables,
39power-on reset signals, external interrupts, cascading, or other system
40functions. Twelve of these pins offer PWM functionality. Using these pins, the
41UCD90160 offers support for margining, and general-purpose PWM functions.
42
Guenter Roeck0c0a0612011-03-08 22:01:39 -080043The UCD9090 is a 10-rail PMBus/I2C addressable power-supply sequencer and
44monitor. The device integrates a 12-bit ADC for monitoring up to 10 power-supply
45voltage inputs. Twenty-three GPIO pins can be used for power supply enables,
46power-on reset signals, external interrupts, cascading, or other system
47functions. Ten of these pins offer PWM functionality. Using these pins, the
48UCD9090 offers support for margining, and general-purpose PWM functions.
49
50The UCD90910 is a ten-rail I2C / PMBus addressable power-supply sequencer and
51system-health monitor. The device integrates a 12-bit ADC for monitoring up to
5213 power-supply voltage, current, or temperature inputs.
53
54This driver is a client driver to the core PMBus driver. Please see
55Documentation/hwmon/pmbus for details on PMBus client drivers.
56
57
58Usage Notes
59-----------
60
61This driver does not auto-detect devices. You will have to instantiate the
62devices explicitly. Please see Documentation/i2c/instantiating-devices for
63details.
64
65
66Platform data support
67---------------------
68
69The driver supports standard PMBus driver platform data. Please see
70Documentation/hwmon/pmbus for details.
71
72
73Sysfs entries
74-------------
75
76The following attributes are supported. Limits are read-write; all other
77attributes are read-only.
78
79in[1-12]_label "vout[1-12]".
80in[1-12]_input Measured voltage. From READ_VOUT register.
Masanari Iida40e47122012-03-04 23:16:11 +090081in[1-12]_min Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
Guenter Roeck0c0a0612011-03-08 22:01:39 -080082in[1-12]_max Maximum voltage. From VOUT_OV_WARN_LIMIT register.
Masanari Iida40e47122012-03-04 23:16:11 +090083in[1-12]_lcrit Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
Guenter Roeck0c0a0612011-03-08 22:01:39 -080084in[1-12]_crit Critical maximum voltage. From VOUT_OV_FAULT_LIMIT register.
85in[1-12]_min_alarm Voltage low alarm. From VOLTAGE_UV_WARNING status.
86in[1-12]_max_alarm Voltage high alarm. From VOLTAGE_OV_WARNING status.
87in[1-12]_lcrit_alarm Voltage critical low alarm. From VOLTAGE_UV_FAULT status.
88in[1-12]_crit_alarm Voltage critical high alarm. From VOLTAGE_OV_FAULT status.
89
90curr[1-12]_label "iout[1-12]".
91curr[1-12]_input Measured current. From READ_IOUT register.
92curr[1-12]_max Maximum current. From IOUT_OC_WARN_LIMIT register.
Masanari Iida40e47122012-03-04 23:16:11 +090093curr[1-12]_lcrit Critical minimum output current. From IOUT_UC_FAULT_LIMIT
Guenter Roeck0c0a0612011-03-08 22:01:39 -080094 register.
95curr[1-12]_crit Critical maximum current. From IOUT_OC_FAULT_LIMIT register.
96curr[1-12]_max_alarm Current high alarm. From IOUT_OC_WARNING status.
97curr[1-12]_crit_alarm Current critical high alarm. From IOUT_OC_FAULT status.
98
99 For each attribute index, either voltage or current is
100 reported, but not both. If voltage or current is
101 reported depends on the chip configuration.
102
103temp[1-2]_input Measured temperatures. From READ_TEMPERATURE_1 and
104 READ_TEMPERATURE_2 registers.
105temp[1-2]_max Maximum temperature. From OT_WARN_LIMIT register.
106temp[1-2]_crit Critical high temperature. From OT_FAULT_LIMIT register.
107temp[1-2]_max_alarm Temperature high alarm.
108temp[1-2]_crit_alarm Temperature critical high alarm.
109
110fan[1-4]_input Fan RPM.
111fan[1-4]_alarm Fan alarm.
112fan[1-4]_fault Fan fault.
113
114 Fan attributes are only available on chips supporting
115 fan control (UCD90124, UCD90910). Attribute files are
116 created only for enabled fans.
117 Note that even though UCD90910 supports up to 10 fans,
118 only up to four fans are currently supported.