Blame view

Documentation/hwmon/ucd9000.rst 5.57 KB
0c0a06151   Guenter Roeck   hwmon: (pmbus) Su...
1
2
3
4
  Kernel driver ucd9000
  =====================
  
  Supported chips:
1f234ff16   Mauro Carvalho Chehab   docs: hwmon: pmbu...
5

a470f11c5   Jim Wright   hwmon: (pmbus/ucd...
6
    * TI UCD90120, UCD90124, UCD90160, UCD90320, UCD9090, and UCD90910
1f234ff16   Mauro Carvalho Chehab   docs: hwmon: pmbu...
7

a470f11c5   Jim Wright   hwmon: (pmbus/ucd...
8
9
      Prefixes: 'ucd90120', 'ucd90124', 'ucd90160', 'ucd90320', 'ucd9090',
                'ucd90910'
1f234ff16   Mauro Carvalho Chehab   docs: hwmon: pmbu...
10

0c0a06151   Guenter Roeck   hwmon: (pmbus) Su...
11
      Addresses scanned: -
1f234ff16   Mauro Carvalho Chehab   docs: hwmon: pmbu...
12

0c0a06151   Guenter Roeck   hwmon: (pmbus) Su...
13
      Datasheets:
1f234ff16   Mauro Carvalho Chehab   docs: hwmon: pmbu...
14
15
16
17
  
  	- http://focus.ti.com/lit/ds/symlink/ucd90120.pdf
  	- http://focus.ti.com/lit/ds/symlink/ucd90124.pdf
  	- http://focus.ti.com/lit/ds/symlink/ucd90160.pdf
a470f11c5   Jim Wright   hwmon: (pmbus/ucd...
18
  	- http://focus.ti.com/lit/ds/symlink/ucd90320.pdf
1f234ff16   Mauro Carvalho Chehab   docs: hwmon: pmbu...
19
20
  	- http://focus.ti.com/lit/ds/symlink/ucd9090.pdf
  	- http://focus.ti.com/lit/ds/symlink/ucd90910.pdf
0c0a06151   Guenter Roeck   hwmon: (pmbus) Su...
21

e3333e572   Guenter Roeck   hwmon: Update my ...
22
  Author: Guenter Roeck <linux@roeck-us.net>
0c0a06151   Guenter Roeck   hwmon: (pmbus) Su...
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
  
  
  Description
  -----------
  
  From datasheets:
  
  The UCD90120 Power Supply Sequencer and System Health Monitor monitors and
  sequences up to 12 independent voltage rails. The device integrates a 12-bit
  ADC with a 2.5V internal reference for monitoring up to 13 power supply voltage,
  current, or temperature inputs.
  
  The UCD90124 is a 12-rail PMBus/I2C addressable power-supply sequencer and
  system-health monitor. The device integrates a 12-bit ADC for monitoring up to
  13 power-supply voltage, current, or temperature inputs. Twenty-six GPIO pins
  can be used for power supply enables, power-on reset signals, external
  interrupts, cascading, or other system functions. Twelve of these pins offer PWM
  functionality. Using these pins, the UCD90124 offers support for fan control,
  margining, and general-purpose PWM functions.
50b2b02c4   Matt Weber   hwmon: (ucd9000) ...
42
43
44
45
46
47
  The UCD90160 is a 16-rail PMBus/I2C addressable power-supply sequencer and
  monitor. The device integrates a 12-bit ADC for monitoring up to 16 power-supply
  voltage inputs. Twenty-six GPIO pins can be used for power supply enables,
  power-on reset signals, external interrupts, cascading, or other system
  functions. Twelve of these pins offer PWM functionality. Using these pins, the
  UCD90160 offers support for margining, and general-purpose PWM functions.
a470f11c5   Jim Wright   hwmon: (pmbus/ucd...
48
49
50
51
52
  The UCD90320 is a 32-rail PMBus/I2C addressable power-supply sequencer and
  monitor. The 24 integrated ADC channels (AMONx) monitor the power supply
  voltage, current, and temperature. Of the 84 GPIO pins, 8 can be used as
  digital monitors (DMONx), 32 to enable the power supply (ENx), 24 for margining
  (MARx), 16 for logical GPO, and 32 GPIs for cascading, and system function.
0c0a06151   Guenter Roeck   hwmon: (pmbus) Su...
53
54
55
56
57
58
59
60
61
62
63
64
  The UCD9090 is a 10-rail PMBus/I2C addressable power-supply sequencer and
  monitor. The device integrates a 12-bit ADC for monitoring up to 10 power-supply
  voltage inputs. Twenty-three GPIO pins can be used for power supply enables,
  power-on reset signals, external interrupts, cascading, or other system
  functions. Ten of these pins offer PWM functionality. Using these pins, the
  UCD9090 offers support for margining, and general-purpose PWM functions.
  
  The UCD90910 is a ten-rail I2C / PMBus addressable power-supply sequencer and
  system-health monitor. The device integrates a 12-bit ADC for monitoring up to
  13 power-supply voltage, current, or temperature inputs.
  
  This driver is a client driver to the core PMBus driver. Please see
7ebd8b66d   Mauro Carvalho Chehab   docs: hwmon: Add ...
65
  Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
0c0a06151   Guenter Roeck   hwmon: (pmbus) Su...
66
67
68
69
70
71
  
  
  Usage Notes
  -----------
  
  This driver does not auto-detect devices. You will have to instantiate the
ccf988b66   Mauro Carvalho Chehab   docs: i2c: conver...
72
  devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
0c0a06151   Guenter Roeck   hwmon: (pmbus) Su...
73
74
75
76
77
78
79
  details.
  
  
  Platform data support
  ---------------------
  
  The driver supports standard PMBus driver platform data. Please see
7ebd8b66d   Mauro Carvalho Chehab   docs: hwmon: Add ...
80
  Documentation/hwmon/pmbus.rst for details.
0c0a06151   Guenter Roeck   hwmon: (pmbus) Su...
81
82
83
84
85
86
87
  
  
  Sysfs entries
  -------------
  
  The following attributes are supported. Limits are read-write; all other
  attributes are read-only.
1f234ff16   Mauro Carvalho Chehab   docs: hwmon: pmbu...
88
  ======================= ========================================================
0c0a06151   Guenter Roeck   hwmon: (pmbus) Su...
89
90
  in[1-12]_label		"vout[1-12]".
  in[1-12]_input		Measured voltage. From READ_VOUT register.
40e47125e   Masanari Iida   Documentation: Fi...
91
  in[1-12]_min		Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
0c0a06151   Guenter Roeck   hwmon: (pmbus) Su...
92
  in[1-12]_max		Maximum voltage. From VOUT_OV_WARN_LIMIT register.
40e47125e   Masanari Iida   Documentation: Fi...
93
  in[1-12]_lcrit		Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
1f234ff16   Mauro Carvalho Chehab   docs: hwmon: pmbu...
94
95
  in[1-12]_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
  			register.
0c0a06151   Guenter Roeck   hwmon: (pmbus) Su...
96
97
  in[1-12]_min_alarm	Voltage low alarm. From VOLTAGE_UV_WARNING status.
  in[1-12]_max_alarm	Voltage high alarm. From VOLTAGE_OV_WARNING status.
1f234ff16   Mauro Carvalho Chehab   docs: hwmon: pmbu...
98
99
100
101
  in[1-12]_lcrit_alarm	Voltage critical low alarm. From VOLTAGE_UV_FAULT
  			status.
  in[1-12]_crit_alarm	Voltage critical high alarm. From VOLTAGE_OV_FAULT
  			status.
0c0a06151   Guenter Roeck   hwmon: (pmbus) Su...
102
103
104
105
  
  curr[1-12]_label	"iout[1-12]".
  curr[1-12]_input	Measured current. From READ_IOUT register.
  curr[1-12]_max		Maximum current. From IOUT_OC_WARN_LIMIT register.
1f234ff16   Mauro Carvalho Chehab   docs: hwmon: pmbu...
106
107
108
  curr[1-12]_lcrit	Critical minimum output current. From
  			IOUT_UC_FAULT_LIMIT register.
  curr[1-12]_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT
0c0a06151   Guenter Roeck   hwmon: (pmbus) Su...
109
  			register.
0c0a06151   Guenter Roeck   hwmon: (pmbus) Su...
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
  curr[1-12]_max_alarm	Current high alarm. From IOUT_OC_WARNING status.
  curr[1-12]_crit_alarm	Current critical high alarm. From IOUT_OC_FAULT status.
  
  			For each attribute index, either voltage or current is
  			reported, but not both. If voltage or current is
  			reported depends on the chip configuration.
  
  temp[1-2]_input		Measured temperatures. From READ_TEMPERATURE_1 and
  			READ_TEMPERATURE_2 registers.
  temp[1-2]_max		Maximum temperature. From OT_WARN_LIMIT register.
  temp[1-2]_crit		Critical high temperature. From OT_FAULT_LIMIT register.
  temp[1-2]_max_alarm	Temperature high alarm.
  temp[1-2]_crit_alarm	Temperature critical high alarm.
  
  fan[1-4]_input		Fan RPM.
  fan[1-4]_alarm		Fan alarm.
  fan[1-4]_fault		Fan fault.
  
  			Fan attributes are only available on chips supporting
  			fan control (UCD90124, UCD90910). Attribute files are
  			created only for enabled fans.
  			Note that even though UCD90910 supports up to 10 fans,
  			only up to four fans are currently supported.
1f234ff16   Mauro Carvalho Chehab   docs: hwmon: pmbu...
133
  ======================= ========================================================