]>
Commit | Line | Data |
---|---|---|
e428d8d3 GR |
1 | Kernel driver max34440 |
2 | ====================== | |
3 | ||
4 | Supported chips: | |
5 | * Maxim MAX34440 | |
6 | Prefixes: 'max34440' | |
7 | Addresses scanned: - | |
8 | Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX34440.pdf | |
9 | * Maxim MAX34441 | |
10 | PMBus 5-Channel Power-Supply Manager and Intelligent Fan Controller | |
11 | Prefixes: 'max34441' | |
12 | Addresses scanned: - | |
13 | Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX34441.pdf | |
590defe5 GR |
14 | * Maxim MAX34446 |
15 | PMBus Power-Supply Data Logger | |
16 | Prefixes: 'max34446' | |
17 | Addresses scanned: - | |
18 | Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX34446.pdf | |
50115ac9 GR |
19 | * Maxim MAX34460 |
20 | PMBus 12-Channel Voltage Monitor & Sequencer | |
21 | Prefix: 'max34460' | |
22 | Addresses scanned: - | |
23 | Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX34460.pdf | |
24 | * Maxim MAX34461 | |
25 | PMBus 16-Channel Voltage Monitor & Sequencer | |
26 | Prefix: 'max34461' | |
27 | Addresses scanned: - | |
28 | Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX34461.pdf | |
e428d8d3 | 29 | |
e3333e57 | 30 | Author: Guenter Roeck <linux@roeck-us.net> |
e428d8d3 GR |
31 | |
32 | ||
33 | Description | |
34 | ----------- | |
35 | ||
36 | This driver supports hardware montoring for Maxim MAX34440 PMBus 6-Channel | |
590defe5 GR |
37 | Power-Supply Manager, MAX34441 PMBus 5-Channel Power-Supply Manager |
38 | and Intelligent Fan Controller, and MAX34446 PMBus Power-Supply Data Logger. | |
50115ac9 GR |
39 | It also supports the MAX34460 and MAX34461 PMBus Voltage Monitor & Sequencers. |
40 | The MAX34460 supports 12 voltage channels, and the MAX34461 supports 16 voltage | |
41 | channels. | |
e428d8d3 GR |
42 | |
43 | The driver is a client driver to the core PMBus driver. Please see | |
44 | Documentation/hwmon/pmbus for details on PMBus client drivers. | |
45 | ||
46 | ||
47 | Usage Notes | |
48 | ----------- | |
49 | ||
50 | This driver does not auto-detect devices. You will have to instantiate the | |
51 | devices explicitly. Please see Documentation/i2c/instantiating-devices for | |
52 | details. | |
53 | ||
590defe5 GR |
54 | For MAX34446, the value of the currX_crit attribute determines if current or |
55 | voltage measurement is enabled for a given channel. Voltage measurement is | |
56 | enabled if currX_crit is set to 0; current measurement is enabled if the | |
57 | attribute is set to a positive value. Power measurement is only enabled if | |
58 | channel 1 (3) is configured for voltage measurement, and channel 2 (4) is | |
59 | configured for current measurement. | |
60 | ||
e428d8d3 GR |
61 | |
62 | Platform data support | |
63 | --------------------- | |
64 | ||
65 | The driver supports standard PMBus driver platform data. | |
66 | ||
67 | ||
68 | Sysfs entries | |
69 | ------------- | |
70 | ||
71 | The following attributes are supported. Limits are read-write; all other | |
72 | attributes are read-only. | |
73 | ||
74 | in[1-6]_label "vout[1-6]". | |
75 | in[1-6]_input Measured voltage. From READ_VOUT register. | |
40e47125 | 76 | in[1-6]_min Minimum Voltage. From VOUT_UV_WARN_LIMIT register. |
e428d8d3 | 77 | in[1-6]_max Maximum voltage. From VOUT_OV_WARN_LIMIT register. |
40e47125 | 78 | in[1-6]_lcrit Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register. |
e428d8d3 GR |
79 | in[1-6]_crit Critical maximum voltage. From VOUT_OV_FAULT_LIMIT register. |
80 | in[1-6]_min_alarm Voltage low alarm. From VOLTAGE_UV_WARNING status. | |
81 | in[1-6]_max_alarm Voltage high alarm. From VOLTAGE_OV_WARNING status. | |
82 | in[1-6]_lcrit_alarm Voltage critical low alarm. From VOLTAGE_UV_FAULT status. | |
83 | in[1-6]_crit_alarm Voltage critical high alarm. From VOLTAGE_OV_FAULT status. | |
56aad5d1 | 84 | in[1-6]_lowest Historical minimum voltage. |
98591dbe GR |
85 | in[1-6]_highest Historical maximum voltage. |
86 | in[1-6]_reset_history Write any value to reset history. | |
e428d8d3 | 87 | |
590defe5 GR |
88 | MAX34446 only supports in[1-4]. |
89 | ||
e428d8d3 GR |
90 | curr[1-6]_label "iout[1-6]". |
91 | curr[1-6]_input Measured current. From READ_IOUT register. | |
92 | curr[1-6]_max Maximum current. From IOUT_OC_WARN_LIMIT register. | |
93 | curr[1-6]_crit Critical maximum current. From IOUT_OC_FAULT_LIMIT register. | |
94 | curr[1-6]_max_alarm Current high alarm. From IOUT_OC_WARNING status. | |
95 | curr[1-6]_crit_alarm Current critical high alarm. From IOUT_OC_FAULT status. | |
590defe5 | 96 | curr[1-4]_average Historical average current (MAX34446 only). |
98591dbe GR |
97 | curr[1-6]_highest Historical maximum current. |
98 | curr[1-6]_reset_history Write any value to reset history. | |
e428d8d3 GR |
99 | |
100 | in6 and curr6 attributes only exist for MAX34440. | |
590defe5 GR |
101 | MAX34446 only supports curr[1-4]. |
102 | ||
103 | power[1,3]_label "pout[1,3]" | |
104 | power[1,3]_input Measured power. | |
105 | power[1,3]_average Historical average power. | |
106 | power[1,3]_highest Historical maximum power. | |
107 | ||
108 | Power attributes only exist for MAX34446. | |
e428d8d3 GR |
109 | |
110 | temp[1-8]_input Measured temperatures. From READ_TEMPERATURE_1 register. | |
111 | temp1 is the chip's internal temperature. temp2..temp5 | |
112 | are remote I2C temperature sensors. For MAX34441, temp6 | |
113 | is a remote thermal-diode sensor. For MAX34440, temp6..8 | |
114 | are remote I2C temperature sensors. | |
115 | temp[1-8]_max Maximum temperature. From OT_WARN_LIMIT register. | |
116 | temp[1-8]_crit Critical high temperature. From OT_FAULT_LIMIT register. | |
117 | temp[1-8]_max_alarm Temperature high alarm. | |
118 | temp[1-8]_crit_alarm Temperature critical high alarm. | |
590defe5 | 119 | temp[1-8]_average Historical average temperature (MAX34446 only). |
98591dbe GR |
120 | temp[1-8]_highest Historical maximum temperature. |
121 | temp[1-8]_reset_history Write any value to reset history. | |
e428d8d3 GR |
122 | |
123 | temp7 and temp8 attributes only exist for MAX34440. | |
590defe5 | 124 | MAX34446 only supports temp[1-3]. |
50115ac9 GR |
125 | |
126 | MAX34460 supports attribute groups in[1-12] and temp[1-5]. | |
127 | MAX34461 supports attribute groups in[1-16] and temp[1-5]. |