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