xref: /openbmc/linux/drivers/i2c/busses/i2c-cros-ec-tunnel.c (revision 7051924f771722c6dd235e693742cda6488ac700)
1 /*
2  *  Copyright (C) 2013 Google, Inc
3  *
4  *  This program is free software; you can redistribute it and/or modify
5  *  it under the terms of the GNU General Public License as published by
6  *  the Free Software Foundation; either version 2 of the License, or
7  *  (at your option) any later version.
8  *
9  * Expose an I2C passthrough to the ChromeOS EC.
10  */
11 
12 #include <linux/module.h>
13 #include <linux/i2c.h>
14 #include <linux/mfd/cros_ec.h>
15 #include <linux/mfd/cros_ec_commands.h>
16 #include <linux/platform_device.h>
17 #include <linux/slab.h>
18 
19 /**
20  * struct ec_i2c_device - Driver data for I2C tunnel
21  *
22  * @dev: Device node
23  * @adap: I2C adapter
24  * @ec: Pointer to EC device
25  * @remote_bus: The EC bus number we tunnel to on the other side.
26  * @request_buf: Buffer for transmitting data; we expect most transfers to fit.
27  * @response_buf: Buffer for receiving data; we expect most transfers to fit.
28  */
29 
30 struct ec_i2c_device {
31 	struct device *dev;
32 	struct i2c_adapter adap;
33 	struct cros_ec_device *ec;
34 
35 	u16 remote_bus;
36 
37 	u8 request_buf[256];
38 	u8 response_buf[256];
39 };
40 
41 /**
42  * ec_i2c_count_message - Count bytes needed for ec_i2c_construct_message
43  *
44  * @i2c_msgs: The i2c messages to read
45  * @num: The number of i2c messages.
46  *
47  * Returns the number of bytes the messages will take up.
48  */
49 static int ec_i2c_count_message(const struct i2c_msg i2c_msgs[], int num)
50 {
51 	int i;
52 	int size;
53 
54 	size = sizeof(struct ec_params_i2c_passthru);
55 	size += num * sizeof(struct ec_params_i2c_passthru_msg);
56 	for (i = 0; i < num; i++)
57 		if (!(i2c_msgs[i].flags & I2C_M_RD))
58 			size += i2c_msgs[i].len;
59 
60 	return size;
61 }
62 
63 /**
64  * ec_i2c_construct_message - construct a message to go to the EC
65  *
66  * This function effectively stuffs the standard i2c_msg format of Linux into
67  * a format that the EC understands.
68  *
69  * @buf: The buffer to fill.  We assume that the buffer is big enough.
70  * @i2c_msgs: The i2c messages to read.
71  * @num: The number of i2c messages.
72  * @bus_num: The remote bus number we want to talk to.
73  *
74  * Returns 0 or a negative error number.
75  */
76 static int ec_i2c_construct_message(u8 *buf, const struct i2c_msg i2c_msgs[],
77 				    int num, u16 bus_num)
78 {
79 	struct ec_params_i2c_passthru *params;
80 	u8 *out_data;
81 	int i;
82 
83 	out_data = buf + sizeof(struct ec_params_i2c_passthru) +
84 		   num * sizeof(struct ec_params_i2c_passthru_msg);
85 
86 	params = (struct ec_params_i2c_passthru *)buf;
87 	params->port = bus_num;
88 	params->num_msgs = num;
89 	for (i = 0; i < num; i++) {
90 		const struct i2c_msg *i2c_msg = &i2c_msgs[i];
91 		struct ec_params_i2c_passthru_msg *msg = &params->msg[i];
92 
93 		msg->len = i2c_msg->len;
94 		msg->addr_flags = i2c_msg->addr;
95 
96 		if (i2c_msg->flags & I2C_M_TEN)
97 			msg->addr_flags |= EC_I2C_FLAG_10BIT;
98 
99 		if (i2c_msg->flags & I2C_M_RD) {
100 			msg->addr_flags |= EC_I2C_FLAG_READ;
101 		} else {
102 			memcpy(out_data, i2c_msg->buf, msg->len);
103 			out_data += msg->len;
104 		}
105 	}
106 
107 	return 0;
108 }
109 
110 /**
111  * ec_i2c_count_response - Count bytes needed for ec_i2c_parse_response
112  *
113  * @i2c_msgs: The i2c messages to to fill up.
114  * @num: The number of i2c messages expected.
115  *
116  * Returns the number of response bytes expeced.
117  */
118 static int ec_i2c_count_response(struct i2c_msg i2c_msgs[], int num)
119 {
120 	int size;
121 	int i;
122 
123 	size = sizeof(struct ec_response_i2c_passthru);
124 	for (i = 0; i < num; i++)
125 		if (i2c_msgs[i].flags & I2C_M_RD)
126 			size += i2c_msgs[i].len;
127 
128 	return size;
129 }
130 
131 /**
132  * ec_i2c_parse_response - Parse a response from the EC
133  *
134  * We'll take the EC's response and copy it back into msgs.
135  *
136  * @buf: The buffer to parse.
137  * @i2c_msgs: The i2c messages to to fill up.
138  * @num: The number of i2c messages; will be modified to include the actual
139  *	 number received.
140  *
141  * Returns 0 or a negative error number.
142  */
143 static int ec_i2c_parse_response(const u8 *buf, struct i2c_msg i2c_msgs[],
144 				 int *num)
145 {
146 	const struct ec_response_i2c_passthru *resp;
147 	const u8 *in_data;
148 	int i;
149 
150 	in_data = buf + sizeof(struct ec_response_i2c_passthru);
151 
152 	resp = (const struct ec_response_i2c_passthru *)buf;
153 	if (resp->i2c_status & EC_I2C_STATUS_TIMEOUT)
154 		return -ETIMEDOUT;
155 	else if (resp->i2c_status & EC_I2C_STATUS_ERROR)
156 		return -EREMOTEIO;
157 
158 	/* Other side could send us back fewer messages, but not more */
159 	if (resp->num_msgs > *num)
160 		return -EPROTO;
161 	*num = resp->num_msgs;
162 
163 	for (i = 0; i < *num; i++) {
164 		struct i2c_msg *i2c_msg = &i2c_msgs[i];
165 
166 		if (i2c_msgs[i].flags & I2C_M_RD) {
167 			memcpy(i2c_msg->buf, in_data, i2c_msg->len);
168 			in_data += i2c_msg->len;
169 		}
170 	}
171 
172 	return 0;
173 }
174 
175 static int ec_i2c_xfer(struct i2c_adapter *adap, struct i2c_msg i2c_msgs[],
176 		       int num)
177 {
178 	struct ec_i2c_device *bus = adap->algo_data;
179 	struct device *dev = bus->dev;
180 	const u16 bus_num = bus->remote_bus;
181 	int request_len;
182 	int response_len;
183 	u8 *request = NULL;
184 	u8 *response = NULL;
185 	int result;
186 	struct cros_ec_command msg;
187 
188 	request_len = ec_i2c_count_message(i2c_msgs, num);
189 	if (request_len < 0) {
190 		dev_warn(dev, "Error constructing message %d\n", request_len);
191 		result = request_len;
192 		goto exit;
193 	}
194 	response_len = ec_i2c_count_response(i2c_msgs, num);
195 	if (response_len < 0) {
196 		/* Unexpected; no errors should come when NULL response */
197 		dev_warn(dev, "Error preparing response %d\n", response_len);
198 		result = response_len;
199 		goto exit;
200 	}
201 
202 	if (request_len <= ARRAY_SIZE(bus->request_buf)) {
203 		request = bus->request_buf;
204 	} else {
205 		request = kzalloc(request_len, GFP_KERNEL);
206 		if (request == NULL) {
207 			result = -ENOMEM;
208 			goto exit;
209 		}
210 	}
211 	if (response_len <= ARRAY_SIZE(bus->response_buf)) {
212 		response = bus->response_buf;
213 	} else {
214 		response = kzalloc(response_len, GFP_KERNEL);
215 		if (response == NULL) {
216 			result = -ENOMEM;
217 			goto exit;
218 		}
219 	}
220 
221 	ec_i2c_construct_message(request, i2c_msgs, num, bus_num);
222 
223 	msg.version = 0;
224 	msg.command = EC_CMD_I2C_PASSTHRU;
225 	msg.outdata = request;
226 	msg.outsize = request_len;
227 	msg.indata = response;
228 	msg.insize = response_len;
229 
230 	result = bus->ec->cmd_xfer(bus->ec, &msg);
231 	if (result < 0)
232 		goto exit;
233 
234 	result = ec_i2c_parse_response(response, i2c_msgs, &num);
235 	if (result < 0)
236 		goto exit;
237 
238 	/* Indicate success by saying how many messages were sent */
239 	result = num;
240 exit:
241 	if (request != bus->request_buf)
242 		kfree(request);
243 	if (response != bus->response_buf)
244 		kfree(response);
245 
246 	return result;
247 }
248 
249 static u32 ec_i2c_functionality(struct i2c_adapter *adap)
250 {
251 	return I2C_FUNC_I2C | I2C_FUNC_SMBUS_EMUL;
252 }
253 
254 static const struct i2c_algorithm ec_i2c_algorithm = {
255 	.master_xfer	= ec_i2c_xfer,
256 	.functionality	= ec_i2c_functionality,
257 };
258 
259 static int ec_i2c_probe(struct platform_device *pdev)
260 {
261 	struct device_node *np = pdev->dev.of_node;
262 	struct cros_ec_device *ec = dev_get_drvdata(pdev->dev.parent);
263 	struct device *dev = &pdev->dev;
264 	struct ec_i2c_device *bus = NULL;
265 	u32 remote_bus;
266 	int err;
267 
268 	if (!ec->cmd_xfer) {
269 		dev_err(dev, "Missing sendrecv\n");
270 		return -EINVAL;
271 	}
272 
273 	bus = devm_kzalloc(dev, sizeof(*bus), GFP_KERNEL);
274 	if (bus == NULL)
275 		return -ENOMEM;
276 
277 	err = of_property_read_u32(np, "google,remote-bus", &remote_bus);
278 	if (err) {
279 		dev_err(dev, "Couldn't read remote-bus property\n");
280 		return err;
281 	}
282 	bus->remote_bus = remote_bus;
283 
284 	bus->ec = ec;
285 	bus->dev = dev;
286 
287 	bus->adap.owner = THIS_MODULE;
288 	strlcpy(bus->adap.name, "cros-ec-i2c-tunnel", sizeof(bus->adap.name));
289 	bus->adap.algo = &ec_i2c_algorithm;
290 	bus->adap.algo_data = bus;
291 	bus->adap.dev.parent = &pdev->dev;
292 	bus->adap.dev.of_node = np;
293 
294 	err = i2c_add_adapter(&bus->adap);
295 	if (err) {
296 		dev_err(dev, "cannot register i2c adapter\n");
297 		return err;
298 	}
299 	platform_set_drvdata(pdev, bus);
300 
301 	return err;
302 }
303 
304 static int ec_i2c_remove(struct platform_device *dev)
305 {
306 	struct ec_i2c_device *bus = platform_get_drvdata(dev);
307 
308 	i2c_del_adapter(&bus->adap);
309 
310 	return 0;
311 }
312 
313 static struct platform_driver ec_i2c_tunnel_driver = {
314 	.probe = ec_i2c_probe,
315 	.remove = ec_i2c_remove,
316 	.driver = {
317 		.name = "cros-ec-i2c-tunnel",
318 	},
319 };
320 
321 module_platform_driver(ec_i2c_tunnel_driver);
322 
323 MODULE_LICENSE("GPL");
324 MODULE_DESCRIPTION("EC I2C tunnel driver");
325 MODULE_ALIAS("platform:cros-ec-i2c-tunnel");
326