xref: /OK3568_Linux_fs/kernel/drivers/platform/chrome/cros_ec_rpmsg.c (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0
2*4882a593Smuzhiyun //
3*4882a593Smuzhiyun // Copyright 2018 Google LLC.
4*4882a593Smuzhiyun 
5*4882a593Smuzhiyun #include <linux/completion.h>
6*4882a593Smuzhiyun #include <linux/delay.h>
7*4882a593Smuzhiyun #include <linux/kernel.h>
8*4882a593Smuzhiyun #include <linux/module.h>
9*4882a593Smuzhiyun #include <linux/of.h>
10*4882a593Smuzhiyun #include <linux/platform_data/cros_ec_commands.h>
11*4882a593Smuzhiyun #include <linux/platform_data/cros_ec_proto.h>
12*4882a593Smuzhiyun #include <linux/platform_device.h>
13*4882a593Smuzhiyun #include <linux/rpmsg.h>
14*4882a593Smuzhiyun #include <linux/slab.h>
15*4882a593Smuzhiyun 
16*4882a593Smuzhiyun #include "cros_ec.h"
17*4882a593Smuzhiyun 
18*4882a593Smuzhiyun #define EC_MSG_TIMEOUT_MS	200
19*4882a593Smuzhiyun #define HOST_COMMAND_MARK	1
20*4882a593Smuzhiyun #define HOST_EVENT_MARK		2
21*4882a593Smuzhiyun 
22*4882a593Smuzhiyun /**
23*4882a593Smuzhiyun  * struct cros_ec_rpmsg_response - rpmsg message format from from EC.
24*4882a593Smuzhiyun  *
25*4882a593Smuzhiyun  * @type:	The type of message, should be either HOST_COMMAND_MARK or
26*4882a593Smuzhiyun  *		HOST_EVENT_MARK, representing that the message is a response to
27*4882a593Smuzhiyun  *		host command, or a host event.
28*4882a593Smuzhiyun  * @data:	ec_host_response for host command.
29*4882a593Smuzhiyun  */
30*4882a593Smuzhiyun struct cros_ec_rpmsg_response {
31*4882a593Smuzhiyun 	u8 type;
32*4882a593Smuzhiyun 	u8 data[] __aligned(4);
33*4882a593Smuzhiyun };
34*4882a593Smuzhiyun 
35*4882a593Smuzhiyun /**
36*4882a593Smuzhiyun  * struct cros_ec_rpmsg - information about a EC over rpmsg.
37*4882a593Smuzhiyun  *
38*4882a593Smuzhiyun  * @rpdev:	rpmsg device we are connected to
39*4882a593Smuzhiyun  * @xfer_ack:	completion for host command transfer.
40*4882a593Smuzhiyun  * @host_event_work:	Work struct for pending host event.
41*4882a593Smuzhiyun  * @ept: The rpmsg endpoint of this channel.
42*4882a593Smuzhiyun  * @has_pending_host_event: Boolean used to check if there is a pending event.
43*4882a593Smuzhiyun  * @probe_done: Flag to indicate that probe is done.
44*4882a593Smuzhiyun  */
45*4882a593Smuzhiyun struct cros_ec_rpmsg {
46*4882a593Smuzhiyun 	struct rpmsg_device *rpdev;
47*4882a593Smuzhiyun 	struct completion xfer_ack;
48*4882a593Smuzhiyun 	struct work_struct host_event_work;
49*4882a593Smuzhiyun 	struct rpmsg_endpoint *ept;
50*4882a593Smuzhiyun 	bool has_pending_host_event;
51*4882a593Smuzhiyun 	bool probe_done;
52*4882a593Smuzhiyun };
53*4882a593Smuzhiyun 
54*4882a593Smuzhiyun /**
55*4882a593Smuzhiyun  * cros_ec_cmd_xfer_rpmsg - Transfer a message over rpmsg and receive the reply
56*4882a593Smuzhiyun  *
57*4882a593Smuzhiyun  * @ec_dev: ChromeOS EC device
58*4882a593Smuzhiyun  * @ec_msg: Message to transfer
59*4882a593Smuzhiyun  *
60*4882a593Smuzhiyun  * This is only used for old EC proto version, and is not supported for this
61*4882a593Smuzhiyun  * driver.
62*4882a593Smuzhiyun  *
63*4882a593Smuzhiyun  * Return: -EINVAL
64*4882a593Smuzhiyun  */
cros_ec_cmd_xfer_rpmsg(struct cros_ec_device * ec_dev,struct cros_ec_command * ec_msg)65*4882a593Smuzhiyun static int cros_ec_cmd_xfer_rpmsg(struct cros_ec_device *ec_dev,
66*4882a593Smuzhiyun 				  struct cros_ec_command *ec_msg)
67*4882a593Smuzhiyun {
68*4882a593Smuzhiyun 	return -EINVAL;
69*4882a593Smuzhiyun }
70*4882a593Smuzhiyun 
71*4882a593Smuzhiyun /**
72*4882a593Smuzhiyun  * cros_ec_pkt_xfer_rpmsg - Transfer a packet over rpmsg and receive the reply
73*4882a593Smuzhiyun  *
74*4882a593Smuzhiyun  * @ec_dev: ChromeOS EC device
75*4882a593Smuzhiyun  * @ec_msg: Message to transfer
76*4882a593Smuzhiyun  *
77*4882a593Smuzhiyun  * Return: number of bytes of the reply on success or negative error code.
78*4882a593Smuzhiyun  */
cros_ec_pkt_xfer_rpmsg(struct cros_ec_device * ec_dev,struct cros_ec_command * ec_msg)79*4882a593Smuzhiyun static int cros_ec_pkt_xfer_rpmsg(struct cros_ec_device *ec_dev,
80*4882a593Smuzhiyun 				  struct cros_ec_command *ec_msg)
81*4882a593Smuzhiyun {
82*4882a593Smuzhiyun 	struct cros_ec_rpmsg *ec_rpmsg = ec_dev->priv;
83*4882a593Smuzhiyun 	struct ec_host_response *response;
84*4882a593Smuzhiyun 	unsigned long timeout;
85*4882a593Smuzhiyun 	int len;
86*4882a593Smuzhiyun 	int ret;
87*4882a593Smuzhiyun 	u8 sum;
88*4882a593Smuzhiyun 	int i;
89*4882a593Smuzhiyun 
90*4882a593Smuzhiyun 	ec_msg->result = 0;
91*4882a593Smuzhiyun 	len = cros_ec_prepare_tx(ec_dev, ec_msg);
92*4882a593Smuzhiyun 	dev_dbg(ec_dev->dev, "prepared, len=%d\n", len);
93*4882a593Smuzhiyun 
94*4882a593Smuzhiyun 	reinit_completion(&ec_rpmsg->xfer_ack);
95*4882a593Smuzhiyun 	ret = rpmsg_send(ec_rpmsg->ept, ec_dev->dout, len);
96*4882a593Smuzhiyun 	if (ret) {
97*4882a593Smuzhiyun 		dev_err(ec_dev->dev, "rpmsg send failed\n");
98*4882a593Smuzhiyun 		return ret;
99*4882a593Smuzhiyun 	}
100*4882a593Smuzhiyun 
101*4882a593Smuzhiyun 	timeout = msecs_to_jiffies(EC_MSG_TIMEOUT_MS);
102*4882a593Smuzhiyun 	ret = wait_for_completion_timeout(&ec_rpmsg->xfer_ack, timeout);
103*4882a593Smuzhiyun 	if (!ret) {
104*4882a593Smuzhiyun 		dev_err(ec_dev->dev, "rpmsg send timeout\n");
105*4882a593Smuzhiyun 		return -EIO;
106*4882a593Smuzhiyun 	}
107*4882a593Smuzhiyun 
108*4882a593Smuzhiyun 	/* check response error code */
109*4882a593Smuzhiyun 	response = (struct ec_host_response *)ec_dev->din;
110*4882a593Smuzhiyun 	ec_msg->result = response->result;
111*4882a593Smuzhiyun 
112*4882a593Smuzhiyun 	ret = cros_ec_check_result(ec_dev, ec_msg);
113*4882a593Smuzhiyun 	if (ret)
114*4882a593Smuzhiyun 		goto exit;
115*4882a593Smuzhiyun 
116*4882a593Smuzhiyun 	if (response->data_len > ec_msg->insize) {
117*4882a593Smuzhiyun 		dev_err(ec_dev->dev, "packet too long (%d bytes, expected %d)",
118*4882a593Smuzhiyun 			response->data_len, ec_msg->insize);
119*4882a593Smuzhiyun 		ret = -EMSGSIZE;
120*4882a593Smuzhiyun 		goto exit;
121*4882a593Smuzhiyun 	}
122*4882a593Smuzhiyun 
123*4882a593Smuzhiyun 	/* copy response packet payload and compute checksum */
124*4882a593Smuzhiyun 	memcpy(ec_msg->data, ec_dev->din + sizeof(*response),
125*4882a593Smuzhiyun 	       response->data_len);
126*4882a593Smuzhiyun 
127*4882a593Smuzhiyun 	sum = 0;
128*4882a593Smuzhiyun 	for (i = 0; i < sizeof(*response) + response->data_len; i++)
129*4882a593Smuzhiyun 		sum += ec_dev->din[i];
130*4882a593Smuzhiyun 
131*4882a593Smuzhiyun 	if (sum) {
132*4882a593Smuzhiyun 		dev_err(ec_dev->dev, "bad packet checksum, calculated %x\n",
133*4882a593Smuzhiyun 			sum);
134*4882a593Smuzhiyun 		ret = -EBADMSG;
135*4882a593Smuzhiyun 		goto exit;
136*4882a593Smuzhiyun 	}
137*4882a593Smuzhiyun 
138*4882a593Smuzhiyun 	ret = response->data_len;
139*4882a593Smuzhiyun exit:
140*4882a593Smuzhiyun 	if (ec_msg->command == EC_CMD_REBOOT_EC)
141*4882a593Smuzhiyun 		msleep(EC_REBOOT_DELAY_MS);
142*4882a593Smuzhiyun 
143*4882a593Smuzhiyun 	return ret;
144*4882a593Smuzhiyun }
145*4882a593Smuzhiyun 
146*4882a593Smuzhiyun static void
cros_ec_rpmsg_host_event_function(struct work_struct * host_event_work)147*4882a593Smuzhiyun cros_ec_rpmsg_host_event_function(struct work_struct *host_event_work)
148*4882a593Smuzhiyun {
149*4882a593Smuzhiyun 	struct cros_ec_rpmsg *ec_rpmsg = container_of(host_event_work,
150*4882a593Smuzhiyun 						      struct cros_ec_rpmsg,
151*4882a593Smuzhiyun 						      host_event_work);
152*4882a593Smuzhiyun 	struct cros_ec_device *ec_dev = dev_get_drvdata(&ec_rpmsg->rpdev->dev);
153*4882a593Smuzhiyun 	bool ec_has_more_events;
154*4882a593Smuzhiyun 
155*4882a593Smuzhiyun 	do {
156*4882a593Smuzhiyun 		ec_has_more_events = cros_ec_handle_event(ec_dev);
157*4882a593Smuzhiyun 	} while (ec_has_more_events);
158*4882a593Smuzhiyun }
159*4882a593Smuzhiyun 
cros_ec_rpmsg_callback(struct rpmsg_device * rpdev,void * data,int len,void * priv,u32 src)160*4882a593Smuzhiyun static int cros_ec_rpmsg_callback(struct rpmsg_device *rpdev, void *data,
161*4882a593Smuzhiyun 				  int len, void *priv, u32 src)
162*4882a593Smuzhiyun {
163*4882a593Smuzhiyun 	struct cros_ec_device *ec_dev = dev_get_drvdata(&rpdev->dev);
164*4882a593Smuzhiyun 	struct cros_ec_rpmsg *ec_rpmsg = ec_dev->priv;
165*4882a593Smuzhiyun 	struct cros_ec_rpmsg_response *resp;
166*4882a593Smuzhiyun 
167*4882a593Smuzhiyun 	if (!len) {
168*4882a593Smuzhiyun 		dev_warn(ec_dev->dev, "rpmsg received empty response");
169*4882a593Smuzhiyun 		return -EINVAL;
170*4882a593Smuzhiyun 	}
171*4882a593Smuzhiyun 
172*4882a593Smuzhiyun 	resp = data;
173*4882a593Smuzhiyun 	len -= offsetof(struct cros_ec_rpmsg_response, data);
174*4882a593Smuzhiyun 	if (resp->type == HOST_COMMAND_MARK) {
175*4882a593Smuzhiyun 		if (len > ec_dev->din_size) {
176*4882a593Smuzhiyun 			dev_warn(ec_dev->dev,
177*4882a593Smuzhiyun 				 "received length %d > din_size %d, truncating",
178*4882a593Smuzhiyun 				 len, ec_dev->din_size);
179*4882a593Smuzhiyun 			len = ec_dev->din_size;
180*4882a593Smuzhiyun 		}
181*4882a593Smuzhiyun 
182*4882a593Smuzhiyun 		memcpy(ec_dev->din, resp->data, len);
183*4882a593Smuzhiyun 		complete(&ec_rpmsg->xfer_ack);
184*4882a593Smuzhiyun 	} else if (resp->type == HOST_EVENT_MARK) {
185*4882a593Smuzhiyun 		/*
186*4882a593Smuzhiyun 		 * If the host event is sent before cros_ec_register is
187*4882a593Smuzhiyun 		 * finished, queue the host event.
188*4882a593Smuzhiyun 		 */
189*4882a593Smuzhiyun 		if (ec_rpmsg->probe_done)
190*4882a593Smuzhiyun 			schedule_work(&ec_rpmsg->host_event_work);
191*4882a593Smuzhiyun 		else
192*4882a593Smuzhiyun 			ec_rpmsg->has_pending_host_event = true;
193*4882a593Smuzhiyun 	} else {
194*4882a593Smuzhiyun 		dev_warn(ec_dev->dev, "rpmsg received invalid type = %d",
195*4882a593Smuzhiyun 			 resp->type);
196*4882a593Smuzhiyun 		return -EINVAL;
197*4882a593Smuzhiyun 	}
198*4882a593Smuzhiyun 
199*4882a593Smuzhiyun 	return 0;
200*4882a593Smuzhiyun }
201*4882a593Smuzhiyun 
202*4882a593Smuzhiyun static struct rpmsg_endpoint *
cros_ec_rpmsg_create_ept(struct rpmsg_device * rpdev)203*4882a593Smuzhiyun cros_ec_rpmsg_create_ept(struct rpmsg_device *rpdev)
204*4882a593Smuzhiyun {
205*4882a593Smuzhiyun 	struct rpmsg_channel_info chinfo = {};
206*4882a593Smuzhiyun 
207*4882a593Smuzhiyun 	strscpy(chinfo.name, rpdev->id.name, RPMSG_NAME_SIZE);
208*4882a593Smuzhiyun 	chinfo.src = rpdev->src;
209*4882a593Smuzhiyun 	chinfo.dst = RPMSG_ADDR_ANY;
210*4882a593Smuzhiyun 
211*4882a593Smuzhiyun 	return rpmsg_create_ept(rpdev, cros_ec_rpmsg_callback, NULL, chinfo);
212*4882a593Smuzhiyun }
213*4882a593Smuzhiyun 
cros_ec_rpmsg_probe(struct rpmsg_device * rpdev)214*4882a593Smuzhiyun static int cros_ec_rpmsg_probe(struct rpmsg_device *rpdev)
215*4882a593Smuzhiyun {
216*4882a593Smuzhiyun 	struct device *dev = &rpdev->dev;
217*4882a593Smuzhiyun 	struct cros_ec_rpmsg *ec_rpmsg;
218*4882a593Smuzhiyun 	struct cros_ec_device *ec_dev;
219*4882a593Smuzhiyun 	int ret;
220*4882a593Smuzhiyun 
221*4882a593Smuzhiyun 	ec_dev = devm_kzalloc(dev, sizeof(*ec_dev), GFP_KERNEL);
222*4882a593Smuzhiyun 	if (!ec_dev)
223*4882a593Smuzhiyun 		return -ENOMEM;
224*4882a593Smuzhiyun 
225*4882a593Smuzhiyun 	ec_rpmsg = devm_kzalloc(dev, sizeof(*ec_rpmsg), GFP_KERNEL);
226*4882a593Smuzhiyun 	if (!ec_rpmsg)
227*4882a593Smuzhiyun 		return -ENOMEM;
228*4882a593Smuzhiyun 
229*4882a593Smuzhiyun 	ec_dev->dev = dev;
230*4882a593Smuzhiyun 	ec_dev->priv = ec_rpmsg;
231*4882a593Smuzhiyun 	ec_dev->cmd_xfer = cros_ec_cmd_xfer_rpmsg;
232*4882a593Smuzhiyun 	ec_dev->pkt_xfer = cros_ec_pkt_xfer_rpmsg;
233*4882a593Smuzhiyun 	ec_dev->phys_name = dev_name(&rpdev->dev);
234*4882a593Smuzhiyun 	ec_dev->din_size = sizeof(struct ec_host_response) +
235*4882a593Smuzhiyun 			   sizeof(struct ec_response_get_protocol_info);
236*4882a593Smuzhiyun 	ec_dev->dout_size = sizeof(struct ec_host_request);
237*4882a593Smuzhiyun 	dev_set_drvdata(dev, ec_dev);
238*4882a593Smuzhiyun 
239*4882a593Smuzhiyun 	ec_rpmsg->rpdev = rpdev;
240*4882a593Smuzhiyun 	init_completion(&ec_rpmsg->xfer_ack);
241*4882a593Smuzhiyun 	INIT_WORK(&ec_rpmsg->host_event_work,
242*4882a593Smuzhiyun 		  cros_ec_rpmsg_host_event_function);
243*4882a593Smuzhiyun 
244*4882a593Smuzhiyun 	ec_rpmsg->ept = cros_ec_rpmsg_create_ept(rpdev);
245*4882a593Smuzhiyun 	if (!ec_rpmsg->ept)
246*4882a593Smuzhiyun 		return -ENOMEM;
247*4882a593Smuzhiyun 
248*4882a593Smuzhiyun 	ret = cros_ec_register(ec_dev);
249*4882a593Smuzhiyun 	if (ret < 0) {
250*4882a593Smuzhiyun 		rpmsg_destroy_ept(ec_rpmsg->ept);
251*4882a593Smuzhiyun 		cancel_work_sync(&ec_rpmsg->host_event_work);
252*4882a593Smuzhiyun 		return ret;
253*4882a593Smuzhiyun 	}
254*4882a593Smuzhiyun 
255*4882a593Smuzhiyun 	ec_rpmsg->probe_done = true;
256*4882a593Smuzhiyun 
257*4882a593Smuzhiyun 	if (ec_rpmsg->has_pending_host_event)
258*4882a593Smuzhiyun 		schedule_work(&ec_rpmsg->host_event_work);
259*4882a593Smuzhiyun 
260*4882a593Smuzhiyun 	return 0;
261*4882a593Smuzhiyun }
262*4882a593Smuzhiyun 
cros_ec_rpmsg_remove(struct rpmsg_device * rpdev)263*4882a593Smuzhiyun static void cros_ec_rpmsg_remove(struct rpmsg_device *rpdev)
264*4882a593Smuzhiyun {
265*4882a593Smuzhiyun 	struct cros_ec_device *ec_dev = dev_get_drvdata(&rpdev->dev);
266*4882a593Smuzhiyun 	struct cros_ec_rpmsg *ec_rpmsg = ec_dev->priv;
267*4882a593Smuzhiyun 
268*4882a593Smuzhiyun 	cros_ec_unregister(ec_dev);
269*4882a593Smuzhiyun 	rpmsg_destroy_ept(ec_rpmsg->ept);
270*4882a593Smuzhiyun 	cancel_work_sync(&ec_rpmsg->host_event_work);
271*4882a593Smuzhiyun }
272*4882a593Smuzhiyun 
273*4882a593Smuzhiyun #ifdef CONFIG_PM_SLEEP
cros_ec_rpmsg_suspend(struct device * dev)274*4882a593Smuzhiyun static int cros_ec_rpmsg_suspend(struct device *dev)
275*4882a593Smuzhiyun {
276*4882a593Smuzhiyun 	struct cros_ec_device *ec_dev = dev_get_drvdata(dev);
277*4882a593Smuzhiyun 
278*4882a593Smuzhiyun 	return cros_ec_suspend(ec_dev);
279*4882a593Smuzhiyun }
280*4882a593Smuzhiyun 
cros_ec_rpmsg_resume(struct device * dev)281*4882a593Smuzhiyun static int cros_ec_rpmsg_resume(struct device *dev)
282*4882a593Smuzhiyun {
283*4882a593Smuzhiyun 	struct cros_ec_device *ec_dev = dev_get_drvdata(dev);
284*4882a593Smuzhiyun 
285*4882a593Smuzhiyun 	return cros_ec_resume(ec_dev);
286*4882a593Smuzhiyun }
287*4882a593Smuzhiyun #endif
288*4882a593Smuzhiyun 
289*4882a593Smuzhiyun static SIMPLE_DEV_PM_OPS(cros_ec_rpmsg_pm_ops, cros_ec_rpmsg_suspend,
290*4882a593Smuzhiyun 			 cros_ec_rpmsg_resume);
291*4882a593Smuzhiyun 
292*4882a593Smuzhiyun static const struct of_device_id cros_ec_rpmsg_of_match[] = {
293*4882a593Smuzhiyun 	{ .compatible = "google,cros-ec-rpmsg", },
294*4882a593Smuzhiyun 	{ }
295*4882a593Smuzhiyun };
296*4882a593Smuzhiyun MODULE_DEVICE_TABLE(of, cros_ec_rpmsg_of_match);
297*4882a593Smuzhiyun 
298*4882a593Smuzhiyun static struct rpmsg_driver cros_ec_driver_rpmsg = {
299*4882a593Smuzhiyun 	.drv = {
300*4882a593Smuzhiyun 		.name   = "cros-ec-rpmsg",
301*4882a593Smuzhiyun 		.of_match_table = cros_ec_rpmsg_of_match,
302*4882a593Smuzhiyun 		.pm	= &cros_ec_rpmsg_pm_ops,
303*4882a593Smuzhiyun 	},
304*4882a593Smuzhiyun 	.probe		= cros_ec_rpmsg_probe,
305*4882a593Smuzhiyun 	.remove		= cros_ec_rpmsg_remove,
306*4882a593Smuzhiyun };
307*4882a593Smuzhiyun 
308*4882a593Smuzhiyun module_rpmsg_driver(cros_ec_driver_rpmsg);
309*4882a593Smuzhiyun 
310*4882a593Smuzhiyun MODULE_LICENSE("GPL v2");
311*4882a593Smuzhiyun MODULE_DESCRIPTION("ChromeOS EC multi function device (rpmsg)");
312