xref: /rk3399_rockchip-uboot/drivers/misc/cros_ec_lpc.c (revision 72a38e06a20129209eaa0e5211cbf50b192de688)
1c8d3328aSHung-ying Tyan /*
2c8d3328aSHung-ying Tyan  * Chromium OS cros_ec driver - LPC interface
3c8d3328aSHung-ying Tyan  *
4c8d3328aSHung-ying Tyan  * Copyright (c) 2012 The Chromium OS Authors.
5c8d3328aSHung-ying Tyan  *
61a459660SWolfgang Denk  * SPDX-License-Identifier:	GPL-2.0+
7c8d3328aSHung-ying Tyan  */
8c8d3328aSHung-ying Tyan 
9c8d3328aSHung-ying Tyan /*
10c8d3328aSHung-ying Tyan  * The Matrix Keyboard Protocol driver handles talking to the keyboard
11c8d3328aSHung-ying Tyan  * controller chip. Mostly this is for keyboard functions, but some other
12c8d3328aSHung-ying Tyan  * things have slipped in, so we provide generic services to talk to the
13c8d3328aSHung-ying Tyan  * KBC.
14c8d3328aSHung-ying Tyan  */
15c8d3328aSHung-ying Tyan 
16c8d3328aSHung-ying Tyan #include <common.h>
17*72a38e06SSimon Glass #include <dm.h>
18c8d3328aSHung-ying Tyan #include <command.h>
19c8d3328aSHung-ying Tyan #include <cros_ec.h>
20c8d3328aSHung-ying Tyan #include <asm/io.h>
21c8d3328aSHung-ying Tyan 
22c8d3328aSHung-ying Tyan #ifdef DEBUG_TRACE
23c8d3328aSHung-ying Tyan #define debug_trace(fmt, b...)	debug(fmt, ##b)
24c8d3328aSHung-ying Tyan #else
25c8d3328aSHung-ying Tyan #define debug_trace(fmt, b...)
26c8d3328aSHung-ying Tyan #endif
27c8d3328aSHung-ying Tyan 
28c8d3328aSHung-ying Tyan static int wait_for_sync(struct cros_ec_dev *dev)
29c8d3328aSHung-ying Tyan {
30c8d3328aSHung-ying Tyan 	unsigned long start;
31c8d3328aSHung-ying Tyan 
32c8d3328aSHung-ying Tyan 	start = get_timer(0);
33c8d3328aSHung-ying Tyan 	while (inb(EC_LPC_ADDR_HOST_CMD) & EC_LPC_STATUS_BUSY_MASK) {
34c8d3328aSHung-ying Tyan 		if (get_timer(start) > 1000) {
35c8d3328aSHung-ying Tyan 			debug("%s: Timeout waiting for CROS_EC sync\n",
36c8d3328aSHung-ying Tyan 			      __func__);
37c8d3328aSHung-ying Tyan 			return -1;
38c8d3328aSHung-ying Tyan 		}
39c8d3328aSHung-ying Tyan 	}
40c8d3328aSHung-ying Tyan 
41c8d3328aSHung-ying Tyan 	return 0;
42c8d3328aSHung-ying Tyan }
43c8d3328aSHung-ying Tyan 
44*72a38e06SSimon Glass #ifdef CONFIG_DM_CROS_EC
45*72a38e06SSimon Glass int cros_ec_lpc_command(struct udevice *udev, uint8_t cmd, int cmd_version,
46*72a38e06SSimon Glass 		     const uint8_t *dout, int dout_len,
47*72a38e06SSimon Glass 		     uint8_t **dinp, int din_len)
48*72a38e06SSimon Glass {
49*72a38e06SSimon Glass 	struct cros_ec_dev *dev = dev_get_uclass_priv(udev);
50*72a38e06SSimon Glass #else
51c8d3328aSHung-ying Tyan int cros_ec_lpc_command(struct cros_ec_dev *dev, uint8_t cmd, int cmd_version,
52c8d3328aSHung-ying Tyan 		     const uint8_t *dout, int dout_len,
53c8d3328aSHung-ying Tyan 		     uint8_t **dinp, int din_len)
54c8d3328aSHung-ying Tyan {
55*72a38e06SSimon Glass #endif
56c8d3328aSHung-ying Tyan 	const int cmd_addr = EC_LPC_ADDR_HOST_CMD;
57c8d3328aSHung-ying Tyan 	const int data_addr = EC_LPC_ADDR_HOST_DATA;
58c8d3328aSHung-ying Tyan 	const int args_addr = EC_LPC_ADDR_HOST_ARGS;
59c8d3328aSHung-ying Tyan 	const int param_addr = EC_LPC_ADDR_HOST_PARAM;
60c8d3328aSHung-ying Tyan 
61c8d3328aSHung-ying Tyan 	struct ec_lpc_host_args args;
62c8d3328aSHung-ying Tyan 	uint8_t *d;
63c8d3328aSHung-ying Tyan 	int csum;
64c8d3328aSHung-ying Tyan 	int i;
65c8d3328aSHung-ying Tyan 
66f1269925SSimon Glass 	if (dout_len > EC_PROTO2_MAX_PARAM_SIZE) {
67c8d3328aSHung-ying Tyan 		debug("%s: Cannot send %d bytes\n", __func__, dout_len);
68c8d3328aSHung-ying Tyan 		return -1;
69c8d3328aSHung-ying Tyan 	}
70c8d3328aSHung-ying Tyan 
71c8d3328aSHung-ying Tyan 	/* Fill in args */
72c8d3328aSHung-ying Tyan 	args.flags = EC_HOST_ARGS_FLAG_FROM_HOST;
73c8d3328aSHung-ying Tyan 	args.command_version = cmd_version;
74c8d3328aSHung-ying Tyan 	args.data_size = dout_len;
75c8d3328aSHung-ying Tyan 
76c8d3328aSHung-ying Tyan 	/* Calculate checksum */
77c8d3328aSHung-ying Tyan 	csum = cmd + args.flags + args.command_version + args.data_size;
78c8d3328aSHung-ying Tyan 	for (i = 0, d = (uint8_t *)dout; i < dout_len; i++, d++)
79c8d3328aSHung-ying Tyan 		csum += *d;
80c8d3328aSHung-ying Tyan 
81c8d3328aSHung-ying Tyan 	args.checksum = (uint8_t)csum;
82c8d3328aSHung-ying Tyan 
83c8d3328aSHung-ying Tyan 	if (wait_for_sync(dev)) {
84c8d3328aSHung-ying Tyan 		debug("%s: Timeout waiting ready\n", __func__);
85c8d3328aSHung-ying Tyan 		return -1;
86c8d3328aSHung-ying Tyan 	}
87c8d3328aSHung-ying Tyan 
88c8d3328aSHung-ying Tyan 	/* Write args */
89c8d3328aSHung-ying Tyan 	for (i = 0, d = (uint8_t *)&args; i < sizeof(args); i++, d++)
90c8d3328aSHung-ying Tyan 		outb(*d, args_addr + i);
91c8d3328aSHung-ying Tyan 
92c8d3328aSHung-ying Tyan 	/* Write data, if any */
93c8d3328aSHung-ying Tyan 	debug_trace("cmd: %02x, ver: %02x", cmd, cmd_version);
94c8d3328aSHung-ying Tyan 	for (i = 0, d = (uint8_t *)dout; i < dout_len; i++, d++) {
95c8d3328aSHung-ying Tyan 		outb(*d, param_addr + i);
96c8d3328aSHung-ying Tyan 		debug_trace("%02x ", *d);
97c8d3328aSHung-ying Tyan 	}
98c8d3328aSHung-ying Tyan 
99c8d3328aSHung-ying Tyan 	outb(cmd, cmd_addr);
100c8d3328aSHung-ying Tyan 	debug_trace("\n");
101c8d3328aSHung-ying Tyan 
102c8d3328aSHung-ying Tyan 	if (wait_for_sync(dev)) {
103c8d3328aSHung-ying Tyan 		debug("%s: Timeout waiting for response\n", __func__);
104c8d3328aSHung-ying Tyan 		return -1;
105c8d3328aSHung-ying Tyan 	}
106c8d3328aSHung-ying Tyan 
107c8d3328aSHung-ying Tyan 	/* Check result */
108c8d3328aSHung-ying Tyan 	i = inb(data_addr);
109c8d3328aSHung-ying Tyan 	if (i) {
110c8d3328aSHung-ying Tyan 		debug("%s: CROS_EC result code %d\n", __func__, i);
111c8d3328aSHung-ying Tyan 		return -i;
112c8d3328aSHung-ying Tyan 	}
113c8d3328aSHung-ying Tyan 
114c8d3328aSHung-ying Tyan 	/* Read back args */
115c8d3328aSHung-ying Tyan 	for (i = 0, d = (uint8_t *)&args; i < sizeof(args); i++, d++)
116c8d3328aSHung-ying Tyan 		*d = inb(args_addr + i);
117c8d3328aSHung-ying Tyan 
118c8d3328aSHung-ying Tyan 	/*
119c8d3328aSHung-ying Tyan 	 * If EC didn't modify args flags, then somehow we sent a new-style
120c8d3328aSHung-ying Tyan 	 * command to an old EC, which means it would have read its params
121c8d3328aSHung-ying Tyan 	 * from the wrong place.
122c8d3328aSHung-ying Tyan 	 */
123c8d3328aSHung-ying Tyan 	if (!(args.flags & EC_HOST_ARGS_FLAG_TO_HOST)) {
124c8d3328aSHung-ying Tyan 		debug("%s: CROS_EC protocol mismatch\n", __func__);
125c8d3328aSHung-ying Tyan 		return -EC_RES_INVALID_RESPONSE;
126c8d3328aSHung-ying Tyan 	}
127c8d3328aSHung-ying Tyan 
128c8d3328aSHung-ying Tyan 	if (args.data_size > din_len) {
129c8d3328aSHung-ying Tyan 		debug("%s: CROS_EC returned too much data %d > %d\n",
130c8d3328aSHung-ying Tyan 		      __func__, args.data_size, din_len);
131c8d3328aSHung-ying Tyan 		return -EC_RES_INVALID_RESPONSE;
132c8d3328aSHung-ying Tyan 	}
133c8d3328aSHung-ying Tyan 
134c8d3328aSHung-ying Tyan 	/* Read data, if any */
135c8d3328aSHung-ying Tyan 	for (i = 0, d = (uint8_t *)dev->din; i < args.data_size; i++, d++) {
136c8d3328aSHung-ying Tyan 		*d = inb(param_addr + i);
137c8d3328aSHung-ying Tyan 		debug_trace("%02x ", *d);
138c8d3328aSHung-ying Tyan 	}
139c8d3328aSHung-ying Tyan 	debug_trace("\n");
140c8d3328aSHung-ying Tyan 
141c8d3328aSHung-ying Tyan 	/* Verify checksum */
142c8d3328aSHung-ying Tyan 	csum = cmd + args.flags + args.command_version + args.data_size;
143c8d3328aSHung-ying Tyan 	for (i = 0, d = (uint8_t *)dev->din; i < args.data_size; i++, d++)
144c8d3328aSHung-ying Tyan 		csum += *d;
145c8d3328aSHung-ying Tyan 
146c8d3328aSHung-ying Tyan 	if (args.checksum != (uint8_t)csum) {
147c8d3328aSHung-ying Tyan 		debug("%s: CROS_EC response has invalid checksum\n", __func__);
148c8d3328aSHung-ying Tyan 		return -EC_RES_INVALID_CHECKSUM;
149c8d3328aSHung-ying Tyan 	}
150c8d3328aSHung-ying Tyan 	*dinp = dev->din;
151c8d3328aSHung-ying Tyan 
152c8d3328aSHung-ying Tyan 	/* Return actual amount of data received */
153c8d3328aSHung-ying Tyan 	return args.data_size;
154c8d3328aSHung-ying Tyan }
155c8d3328aSHung-ying Tyan 
156c8d3328aSHung-ying Tyan /**
157c8d3328aSHung-ying Tyan  * Initialize LPC protocol.
158c8d3328aSHung-ying Tyan  *
159c8d3328aSHung-ying Tyan  * @param dev		CROS_EC device
160c8d3328aSHung-ying Tyan  * @param blob		Device tree blob
161c8d3328aSHung-ying Tyan  * @return 0 if ok, -1 on error
162c8d3328aSHung-ying Tyan  */
163c8d3328aSHung-ying Tyan int cros_ec_lpc_init(struct cros_ec_dev *dev, const void *blob)
164c8d3328aSHung-ying Tyan {
165c8d3328aSHung-ying Tyan 	int byte, i;
166c8d3328aSHung-ying Tyan 
167c8d3328aSHung-ying Tyan 	/* See if we can find an EC at the other end */
168c8d3328aSHung-ying Tyan 	byte = 0xff;
169c8d3328aSHung-ying Tyan 	byte &= inb(EC_LPC_ADDR_HOST_CMD);
170c8d3328aSHung-ying Tyan 	byte &= inb(EC_LPC_ADDR_HOST_DATA);
171f1269925SSimon Glass 	for (i = 0; i < EC_PROTO2_MAX_PARAM_SIZE && (byte == 0xff); i++)
172c8d3328aSHung-ying Tyan 		byte &= inb(EC_LPC_ADDR_HOST_PARAM + i);
173c8d3328aSHung-ying Tyan 	if (byte == 0xff) {
174c8d3328aSHung-ying Tyan 		debug("%s: CROS_EC device not found on LPC bus\n",
175c8d3328aSHung-ying Tyan 			__func__);
176c8d3328aSHung-ying Tyan 		return -1;
177c8d3328aSHung-ying Tyan 	}
178c8d3328aSHung-ying Tyan 
179c8d3328aSHung-ying Tyan 	return 0;
180c8d3328aSHung-ying Tyan }
181c8d3328aSHung-ying Tyan 
182c8d3328aSHung-ying Tyan /*
183c8d3328aSHung-ying Tyan  * Test if LPC command args are supported.
184c8d3328aSHung-ying Tyan  *
185c8d3328aSHung-ying Tyan  * The cheapest way to do this is by looking for the memory-mapped
186c8d3328aSHung-ying Tyan  * flag.  This is faster than sending a new-style 'hello' command and
187c8d3328aSHung-ying Tyan  * seeing whether the EC sets the EC_HOST_ARGS_FLAG_FROM_HOST flag
188c8d3328aSHung-ying Tyan  * in args when it responds.
189c8d3328aSHung-ying Tyan  */
190*72a38e06SSimon Glass #ifdef CONFIG_DM_CROS_EC
191*72a38e06SSimon Glass static int cros_ec_lpc_check_version(struct udevice *dev)
192*72a38e06SSimon Glass #else
193c8d3328aSHung-ying Tyan int cros_ec_lpc_check_version(struct cros_ec_dev *dev)
194*72a38e06SSimon Glass #endif
195c8d3328aSHung-ying Tyan {
196c8d3328aSHung-ying Tyan 	if (inb(EC_LPC_ADDR_MEMMAP + EC_MEMMAP_ID) == 'E' &&
197c8d3328aSHung-ying Tyan 			inb(EC_LPC_ADDR_MEMMAP + EC_MEMMAP_ID + 1)
198c8d3328aSHung-ying Tyan 				== 'C' &&
199c8d3328aSHung-ying Tyan 			(inb(EC_LPC_ADDR_MEMMAP +
200c8d3328aSHung-ying Tyan 				EC_MEMMAP_HOST_CMD_FLAGS) &
201c8d3328aSHung-ying Tyan 				EC_HOST_CMD_FLAG_LPC_ARGS_SUPPORTED)) {
202c8d3328aSHung-ying Tyan 		return 0;
203c8d3328aSHung-ying Tyan 	}
2044ff9b461SVadim Bendebury 
2054ff9b461SVadim Bendebury 	printf("%s: ERROR: old EC interface not supported\n", __func__);
2064ff9b461SVadim Bendebury 	return -1;
2074ff9b461SVadim Bendebury }
208*72a38e06SSimon Glass 
209*72a38e06SSimon Glass #ifdef CONFIG_DM_CROS_EC
210*72a38e06SSimon Glass static int cros_ec_probe(struct udevice *dev)
211*72a38e06SSimon Glass {
212*72a38e06SSimon Glass 	return cros_ec_register(dev);
213*72a38e06SSimon Glass }
214*72a38e06SSimon Glass 
215*72a38e06SSimon Glass static struct dm_cros_ec_ops cros_ec_ops = {
216*72a38e06SSimon Glass 	.command = cros_ec_lpc_command,
217*72a38e06SSimon Glass 	.check_version = cros_ec_lpc_check_version,
218*72a38e06SSimon Glass };
219*72a38e06SSimon Glass 
220*72a38e06SSimon Glass static const struct udevice_id cros_ec_ids[] = {
221*72a38e06SSimon Glass 	{ .compatible = "google,cros-ec" },
222*72a38e06SSimon Glass 	{ }
223*72a38e06SSimon Glass };
224*72a38e06SSimon Glass 
225*72a38e06SSimon Glass U_BOOT_DRIVER(cros_ec_lpc) = {
226*72a38e06SSimon Glass 	.name		= "cros_ec",
227*72a38e06SSimon Glass 	.id		= UCLASS_CROS_EC,
228*72a38e06SSimon Glass 	.of_match	= cros_ec_ids,
229*72a38e06SSimon Glass 	.probe		= cros_ec_probe,
230*72a38e06SSimon Glass 	.ops		= &cros_ec_ops,
231*72a38e06SSimon Glass };
232*72a38e06SSimon Glass #endif
233