aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--Documentation/hwmon/ucd9200112
-rw-r--r--drivers/hwmon/Kconfig10
-rw-r--r--drivers/hwmon/Makefile1
-rw-r--r--drivers/hwmon/ucd9200.c210
4 files changed, 333 insertions, 0 deletions
diff --git a/Documentation/hwmon/ucd9200 b/Documentation/hwmon/ucd9200
new file mode 100644
index 000000000000..3c58607f72fe
--- /dev/null
+++ b/Documentation/hwmon/ucd9200
@@ -0,0 +1,112 @@
1Kernel driver ucd9200
2=====================
3
4Supported chips:
5 * TI UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, and UCD9248
6 Prefixes: 'ucd9220', 'ucd9222', 'ucd9224', 'ucd9240', 'ucd9244', 'ucd9246',
7 'ucd9248'
8 Addresses scanned: -
9 Datasheets:
10 http://focus.ti.com/lit/ds/symlink/ucd9220.pdf
11 http://focus.ti.com/lit/ds/symlink/ucd9222.pdf
12 http://focus.ti.com/lit/ds/symlink/ucd9224.pdf
13 http://focus.ti.com/lit/ds/symlink/ucd9240.pdf
14 http://focus.ti.com/lit/ds/symlink/ucd9244.pdf
15 http://focus.ti.com/lit/ds/symlink/ucd9246.pdf
16 http://focus.ti.com/lit/ds/symlink/ucd9248.pdf
17
18Author: Guenter Roeck <guenter.roeck@ericsson.com>
19
20
21Description
22-----------
23
24[From datasheets] UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, and
25UCD9248 are multi-rail, multi-phase synchronous buck digital PWM controllers
26designed for non-isolated DC/DC power applications. The devices integrate
27dedicated circuitry for DC/DC loop management with flash memory and a serial
28interface to support configuration, monitoring and management.
29
30This driver is a client driver to the core PMBus driver. Please see
31Documentation/hwmon/pmbus for details on PMBus client drivers.
32
33
34Usage Notes
35-----------
36
37This driver does not auto-detect devices. You will have to instantiate the
38devices explicitly. Please see Documentation/i2c/instantiating-devices for
39details.
40
41
42Platform data support
43---------------------
44
45The driver supports standard PMBus driver platform data. Please see
46Documentation/hwmon/pmbus for details.
47
48
49Sysfs entries
50-------------
51
52The following attributes are supported. Limits are read-write; all other
53attributes are read-only.
54
55in1_label "vin".
56in1_input Measured voltage. From READ_VIN register.
57in1_min Minumum Voltage. From VIN_UV_WARN_LIMIT register.
58in1_max Maximum voltage. From VIN_OV_WARN_LIMIT register.
59in1_lcrit Critical minumum Voltage. VIN_UV_FAULT_LIMIT register.
60in1_crit Critical maximum voltage. From VIN_OV_FAULT_LIMIT register.
61in1_min_alarm Voltage low alarm. From VIN_UV_WARNING status.
62in1_max_alarm Voltage high alarm. From VIN_OV_WARNING status.
63in1_lcrit_alarm Voltage critical low alarm. From VIN_UV_FAULT status.
64in1_crit_alarm Voltage critical high alarm. From VIN_OV_FAULT status.
65
66in[2-5]_label "vout[1-4]".
67in[2-5]_input Measured voltage. From READ_VOUT register.
68in[2-5]_min Minumum Voltage. From VOUT_UV_WARN_LIMIT register.
69in[2-5]_max Maximum voltage. From VOUT_OV_WARN_LIMIT register.
70in[2-5]_lcrit Critical minumum Voltage. VOUT_UV_FAULT_LIMIT register.
71in[2-5]_crit Critical maximum voltage. From VOUT_OV_FAULT_LIMIT register.
72in[2-5]_min_alarm Voltage low alarm. From VOLTAGE_UV_WARNING status.
73in[2-5]_max_alarm Voltage high alarm. From VOLTAGE_OV_WARNING status.
74in[2-5]_lcrit_alarm Voltage critical low alarm. From VOLTAGE_UV_FAULT status.
75in[2-5]_crit_alarm Voltage critical high alarm. From VOLTAGE_OV_FAULT status.
76
77curr1_label "iin".
78curr1_input Measured current. From READ_IIN register.
79
80curr[2-5]_label "iout[1-4]".
81curr[2-5]_input Measured current. From READ_IOUT register.
82curr[2-5]_max Maximum current. From IOUT_OC_WARN_LIMIT register.
83curr[2-5]_lcrit Critical minumum output current. From IOUT_UC_FAULT_LIMIT
84 register.
85curr[2-5]_crit Critical maximum current. From IOUT_OC_FAULT_LIMIT register.
86curr[2-5]_max_alarm Current high alarm. From IOUT_OC_WARNING status.
87curr[2-5]_crit_alarm Current critical high alarm. From IOUT_OC_FAULT status.
88
89power1_input Measured input power. From READ_PIN register.
90power1_label "pin"
91
92power[2-5]_input Measured output power. From READ_POUT register.
93power[2-5]_label "pout[1-4]"
94
95 The number of output voltage, current, and power
96 attribute sets is determined by the number of enabled
97 rails. See chip datasheets for details.
98
99temp[1-5]_input Measured temperatures. From READ_TEMPERATURE_1 and
100 READ_TEMPERATURE_2 registers.
101 temp1 is the chip internal temperature. temp[2-5] are
102 rail temperatures. temp[2-5] attributes are only
103 created for enabled rails. See chip datasheets for
104 details.
105temp[1-5]_max Maximum temperature. From OT_WARN_LIMIT register.
106temp[1-5]_crit Critical high temperature. From OT_FAULT_LIMIT register.
107temp[1-5]_max_alarm Temperature high alarm.
108temp[1-5]_crit_alarm Temperature critical high alarm.
109
110fan1_input Fan RPM. ucd9240 only.
111fan1_alarm Fan alarm. ucd9240 only.
112fan1_fault Fan fault. ucd9240 only.
diff --git a/drivers/hwmon/Kconfig b/drivers/hwmon/Kconfig
index dff080d7a388..07c4a860dffe 100644
--- a/drivers/hwmon/Kconfig
+++ b/drivers/hwmon/Kconfig
@@ -857,6 +857,16 @@ config SENSORS_MAX8688
857 This driver can also be built as a module. If so, the module will 857 This driver can also be built as a module. If so, the module will
858 be called max8688. 858 be called max8688.
859 859
860config SENSORS_UCD9200
861 tristate "TI UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, UCD9248"
862 default n
863 help
864 If you say yes here you get hardware monitoring support for TI
865 UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, and UCD9248.
866
867 This driver can also be built as a module. If so, the module will
868 be called ucd9200.
869
860endif # PMBUS 870endif # PMBUS
861 871
862config SENSORS_SHT15 872config SENSORS_SHT15
diff --git a/drivers/hwmon/Makefile b/drivers/hwmon/Makefile
index 465f1c819fd9..1afe02961dec 100644
--- a/drivers/hwmon/Makefile
+++ b/drivers/hwmon/Makefile
@@ -123,6 +123,7 @@ obj-$(CONFIG_SENSORS_PMBUS) += pmbus.o
123obj-$(CONFIG_SENSORS_MAX16064) += max16064.o 123obj-$(CONFIG_SENSORS_MAX16064) += max16064.o
124obj-$(CONFIG_SENSORS_MAX34440) += max34440.o 124obj-$(CONFIG_SENSORS_MAX34440) += max34440.o
125obj-$(CONFIG_SENSORS_MAX8688) += max8688.o 125obj-$(CONFIG_SENSORS_MAX8688) += max8688.o
126obj-$(CONFIG_SENSORS_UCD9200) += ucd9200.o
126 127
127ccflags-$(CONFIG_HWMON_DEBUG_CHIP) := -DDEBUG 128ccflags-$(CONFIG_HWMON_DEBUG_CHIP) := -DDEBUG
128 129
diff --git a/drivers/hwmon/ucd9200.c b/drivers/hwmon/ucd9200.c
new file mode 100644
index 000000000000..ffcc1cf3609d
--- /dev/null
+++ b/drivers/hwmon/ucd9200.c
@@ -0,0 +1,210 @@
1/*
2 * Hardware monitoring driver for ucd9200 series Digital PWM System Controllers
3 *
4 * Copyright (C) 2011 Ericsson AB.
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
19 */
20
21#include <linux/kernel.h>
22#include <linux/module.h>
23#include <linux/init.h>
24#include <linux/err.h>
25#include <linux/slab.h>
26#include <linux/i2c.h>
27#include <linux/i2c/pmbus.h>
28#include "pmbus.h"
29
30#define UCD9200_PHASE_INFO 0xd2
31#define UCD9200_DEVICE_ID 0xfd
32
33enum chips { ucd9200, ucd9220, ucd9222, ucd9224, ucd9240, ucd9244, ucd9246,
34 ucd9248 };
35
36static const struct i2c_device_id ucd9200_id[] = {
37 {"ucd9200", ucd9200},
38 {"ucd9220", ucd9220},
39 {"ucd9222", ucd9222},
40 {"ucd9224", ucd9224},
41 {"ucd9240", ucd9240},
42 {"ucd9244", ucd9244},
43 {"ucd9246", ucd9246},
44 {"ucd9248", ucd9248},
45 {}
46};
47MODULE_DEVICE_TABLE(i2c, ucd9200_id);
48
49static int ucd9200_probe(struct i2c_client *client,
50 const struct i2c_device_id *id)
51{
52 u8 block_buffer[I2C_SMBUS_BLOCK_MAX + 1];
53 struct pmbus_driver_info *info;
54 const struct i2c_device_id *mid;
55 int i, j, ret;
56
57 if (!i2c_check_functionality(client->adapter,
58 I2C_FUNC_SMBUS_BYTE_DATA |
59 I2C_FUNC_SMBUS_BLOCK_DATA))
60 return -ENODEV;
61
62 ret = i2c_smbus_read_block_data(client, UCD9200_DEVICE_ID,
63 block_buffer);
64 if (ret < 0) {
65 dev_err(&client->dev, "Failed to read device ID\n");
66 return ret;
67 }
68 block_buffer[ret] = '\0';
69 dev_info(&client->dev, "Device ID %s\n", block_buffer);
70
71 mid = NULL;
72 for (i = 0; i < ARRAY_SIZE(ucd9200_id); i++) {
73 mid = &ucd9200_id[i];
74 if (!strncasecmp(mid->name, block_buffer, strlen(mid->name)))
75 break;
76 }
77 if (!mid || !strlen(mid->name)) {
78 dev_err(&client->dev, "Unsupported device\n");
79 return -ENODEV;
80 }
81 if (id->driver_data != ucd9200 && id->driver_data != mid->driver_data)
82 dev_notice(&client->dev,
83 "Device mismatch: Configured %s, detected %s\n",
84 id->name, mid->name);
85
86 info = kzalloc(sizeof(struct pmbus_driver_info), GFP_KERNEL);
87 if (!info)
88 return -ENOMEM;
89
90 ret = i2c_smbus_read_block_data(client, UCD9200_PHASE_INFO,
91 block_buffer);
92 if (ret < 0) {
93 dev_err(&client->dev, "Failed to read phase information\n");
94 goto out;
95 }
96
97 /*
98 * Calculate number of configured pages (rails) from PHASE_INFO
99 * register.
100 * Rails have to be sequential, so we can abort after finding
101 * the first unconfigured rail.
102 */
103 info->pages = 0;
104 for (i = 0; i < ret; i++) {
105 if (!block_buffer[i])
106 break;
107 info->pages++;
108 }
109 if (!info->pages) {
110 dev_err(&client->dev, "No rails configured\n");
111 ret = -ENODEV;
112 goto out;
113 }
114 dev_info(&client->dev, "%d rails configured\n", info->pages);
115
116 /*
117 * Set PHASE registers on all pages to 0xff to ensure that phase
118 * specific commands will apply to all phases of a given page (rail).
119 * This only affects the READ_IOUT and READ_TEMPERATURE2 registers.
120 * READ_IOUT will return the sum of currents of all phases of a rail,
121 * and READ_TEMPERATURE2 will return the maximum temperature detected
122 * for the the phases of the rail.
123 */
124 for (i = 0; i < info->pages; i++) {
125 /*
126 * Setting PAGE & PHASE fails once in a while for no obvious
127 * reason, so we need to retry a couple of times.
128 */
129 for (j = 0; j < 3; j++) {
130 ret = i2c_smbus_write_byte_data(client, PMBUS_PAGE, i);
131 if (ret < 0)
132 continue;
133 ret = i2c_smbus_write_byte_data(client, PMBUS_PHASE,
134 0xff);
135 if (ret < 0)
136 continue;
137 break;
138 }
139 if (ret < 0) {
140 dev_err(&client->dev,
141 "Failed to initialize PHASE registers\n");
142 goto out;
143 }
144 }
145 if (info->pages > 1)
146 i2c_smbus_write_byte_data(client, PMBUS_PAGE, 0);
147
148 info->func[0] = PMBUS_HAVE_VIN | PMBUS_HAVE_STATUS_INPUT |
149 PMBUS_HAVE_IIN | PMBUS_HAVE_PIN |
150 PMBUS_HAVE_VOUT | PMBUS_HAVE_STATUS_VOUT |
151 PMBUS_HAVE_IOUT | PMBUS_HAVE_STATUS_IOUT |
152 PMBUS_HAVE_POUT | PMBUS_HAVE_TEMP |
153 PMBUS_HAVE_TEMP2 | PMBUS_HAVE_STATUS_TEMP;
154
155 for (i = 1; i < info->pages; i++)
156 info->func[i] = PMBUS_HAVE_VOUT | PMBUS_HAVE_STATUS_VOUT |
157 PMBUS_HAVE_IOUT | PMBUS_HAVE_STATUS_IOUT |
158 PMBUS_HAVE_POUT |
159 PMBUS_HAVE_TEMP2 | PMBUS_HAVE_STATUS_TEMP;
160
161 /* ucd9240 supports a single fan */
162 if (mid->driver_data == ucd9240)
163 info->func[0] |= PMBUS_HAVE_FAN12 | PMBUS_HAVE_STATUS_FAN12;
164
165 ret = pmbus_do_probe(client, mid, info);
166 if (ret < 0)
167 goto out;
168 return 0;
169out:
170 kfree(info);
171 return ret;
172}
173
174static int ucd9200_remove(struct i2c_client *client)
175{
176 int ret;
177 const struct pmbus_driver_info *info;
178
179 info = pmbus_get_driver_info(client);
180 ret = pmbus_do_remove(client);
181 kfree(info);
182 return ret;
183}
184
185
186/* This is the driver that will be inserted */
187static struct i2c_driver ucd9200_driver = {
188 .driver = {
189 .name = "ucd9200",
190 },
191 .probe = ucd9200_probe,
192 .remove = ucd9200_remove,
193 .id_table = ucd9200_id,
194};
195
196static int __init ucd9200_init(void)
197{
198 return i2c_add_driver(&ucd9200_driver);
199}
200
201static void __exit ucd9200_exit(void)
202{
203 i2c_del_driver(&ucd9200_driver);
204}
205
206MODULE_AUTHOR("Guenter Roeck");
207MODULE_DESCRIPTION("PMBus driver for TI UCD922x, UCD924x");
208MODULE_LICENSE("GPL");
209module_init(ucd9200_init);
210module_exit(ucd9200_exit);