1*4882a593Smuzhiyun /*
2*4882a593Smuzhiyun * Chromium OS cros_ec driver - SPI 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 <cros_ec.h>
18*4882a593Smuzhiyun #include <dm.h>
19*4882a593Smuzhiyun #include <errno.h>
20*4882a593Smuzhiyun #include <spi.h>
21*4882a593Smuzhiyun
22*4882a593Smuzhiyun DECLARE_GLOBAL_DATA_PTR;
23*4882a593Smuzhiyun
cros_ec_spi_packet(struct udevice * udev,int out_bytes,int in_bytes)24*4882a593Smuzhiyun int cros_ec_spi_packet(struct udevice *udev, int out_bytes, int in_bytes)
25*4882a593Smuzhiyun {
26*4882a593Smuzhiyun struct cros_ec_dev *dev = dev_get_uclass_priv(udev);
27*4882a593Smuzhiyun struct spi_slave *slave = dev_get_parent_priv(dev->dev);
28*4882a593Smuzhiyun ulong start;
29*4882a593Smuzhiyun uint8_t byte;
30*4882a593Smuzhiyun int rv;
31*4882a593Smuzhiyun
32*4882a593Smuzhiyun /* Do the transfer */
33*4882a593Smuzhiyun if (spi_claim_bus(slave)) {
34*4882a593Smuzhiyun debug("%s: Cannot claim SPI bus\n", __func__);
35*4882a593Smuzhiyun return -1;
36*4882a593Smuzhiyun }
37*4882a593Smuzhiyun
38*4882a593Smuzhiyun rv = spi_xfer(slave, out_bytes * 8, dev->dout, NULL, SPI_XFER_BEGIN);
39*4882a593Smuzhiyun if (rv)
40*4882a593Smuzhiyun goto done;
41*4882a593Smuzhiyun start = get_timer(0);
42*4882a593Smuzhiyun while (1) {
43*4882a593Smuzhiyun rv = spi_xfer(slave, 8, NULL, &byte, 0);
44*4882a593Smuzhiyun if (byte == SPI_PREAMBLE_END_BYTE)
45*4882a593Smuzhiyun break;
46*4882a593Smuzhiyun if (rv)
47*4882a593Smuzhiyun goto done;
48*4882a593Smuzhiyun if (get_timer(start) > 100) {
49*4882a593Smuzhiyun rv = -ETIMEDOUT;
50*4882a593Smuzhiyun goto done;
51*4882a593Smuzhiyun }
52*4882a593Smuzhiyun }
53*4882a593Smuzhiyun
54*4882a593Smuzhiyun rv = spi_xfer(slave, in_bytes * 8, NULL, dev->din, 0);
55*4882a593Smuzhiyun done:
56*4882a593Smuzhiyun spi_xfer(slave, 0, NULL, NULL, SPI_XFER_END);
57*4882a593Smuzhiyun spi_release_bus(slave);
58*4882a593Smuzhiyun
59*4882a593Smuzhiyun if (rv) {
60*4882a593Smuzhiyun debug("%s: Cannot complete SPI transfer\n", __func__);
61*4882a593Smuzhiyun return -1;
62*4882a593Smuzhiyun }
63*4882a593Smuzhiyun
64*4882a593Smuzhiyun return in_bytes;
65*4882a593Smuzhiyun }
66*4882a593Smuzhiyun
67*4882a593Smuzhiyun /**
68*4882a593Smuzhiyun * Send a command to a LPC CROS_EC device and return the reply.
69*4882a593Smuzhiyun *
70*4882a593Smuzhiyun * The device's internal input/output buffers are used.
71*4882a593Smuzhiyun *
72*4882a593Smuzhiyun * @param dev CROS_EC device
73*4882a593Smuzhiyun * @param cmd Command to send (EC_CMD_...)
74*4882a593Smuzhiyun * @param cmd_version Version of command to send (EC_VER_...)
75*4882a593Smuzhiyun * @param dout Output data (may be NULL If dout_len=0)
76*4882a593Smuzhiyun * @param dout_len Size of output data in bytes
77*4882a593Smuzhiyun * @param dinp Returns pointer to response data. This will be
78*4882a593Smuzhiyun * untouched unless we return a value > 0.
79*4882a593Smuzhiyun * @param din_len Maximum size of response in bytes
80*4882a593Smuzhiyun * @return number of bytes in response, or -1 on error
81*4882a593Smuzhiyun */
cros_ec_spi_command(struct udevice * udev,uint8_t cmd,int cmd_version,const uint8_t * dout,int dout_len,uint8_t ** dinp,int din_len)82*4882a593Smuzhiyun int cros_ec_spi_command(struct udevice *udev, uint8_t cmd, int cmd_version,
83*4882a593Smuzhiyun const uint8_t *dout, int dout_len,
84*4882a593Smuzhiyun uint8_t **dinp, int din_len)
85*4882a593Smuzhiyun {
86*4882a593Smuzhiyun struct cros_ec_dev *dev = dev_get_uclass_priv(udev);
87*4882a593Smuzhiyun struct spi_slave *slave = dev_get_parent_priv(dev->dev);
88*4882a593Smuzhiyun int in_bytes = din_len + 4; /* status, length, checksum, trailer */
89*4882a593Smuzhiyun uint8_t *out;
90*4882a593Smuzhiyun uint8_t *p;
91*4882a593Smuzhiyun int csum, len;
92*4882a593Smuzhiyun int rv;
93*4882a593Smuzhiyun
94*4882a593Smuzhiyun if (dev->protocol_version != 2) {
95*4882a593Smuzhiyun debug("%s: Unsupported EC protcol version %d\n",
96*4882a593Smuzhiyun __func__, dev->protocol_version);
97*4882a593Smuzhiyun return -1;
98*4882a593Smuzhiyun }
99*4882a593Smuzhiyun
100*4882a593Smuzhiyun /*
101*4882a593Smuzhiyun * Sanity-check input size to make sure it plus transaction overhead
102*4882a593Smuzhiyun * fits in the internal device buffer.
103*4882a593Smuzhiyun */
104*4882a593Smuzhiyun if (in_bytes > sizeof(dev->din)) {
105*4882a593Smuzhiyun debug("%s: Cannot receive %d bytes\n", __func__, din_len);
106*4882a593Smuzhiyun return -1;
107*4882a593Smuzhiyun }
108*4882a593Smuzhiyun
109*4882a593Smuzhiyun /* We represent message length as a byte */
110*4882a593Smuzhiyun if (dout_len > 0xff) {
111*4882a593Smuzhiyun debug("%s: Cannot send %d bytes\n", __func__, dout_len);
112*4882a593Smuzhiyun return -1;
113*4882a593Smuzhiyun }
114*4882a593Smuzhiyun
115*4882a593Smuzhiyun /*
116*4882a593Smuzhiyun * Clear input buffer so we don't get false hits for MSG_HEADER
117*4882a593Smuzhiyun */
118*4882a593Smuzhiyun memset(dev->din, '\0', in_bytes);
119*4882a593Smuzhiyun
120*4882a593Smuzhiyun if (spi_claim_bus(slave)) {
121*4882a593Smuzhiyun debug("%s: Cannot claim SPI bus\n", __func__);
122*4882a593Smuzhiyun return -1;
123*4882a593Smuzhiyun }
124*4882a593Smuzhiyun
125*4882a593Smuzhiyun out = dev->dout;
126*4882a593Smuzhiyun out[0] = EC_CMD_VERSION0 + cmd_version;
127*4882a593Smuzhiyun out[1] = cmd;
128*4882a593Smuzhiyun out[2] = (uint8_t)dout_len;
129*4882a593Smuzhiyun memcpy(out + 3, dout, dout_len);
130*4882a593Smuzhiyun csum = cros_ec_calc_checksum(out, 3)
131*4882a593Smuzhiyun + cros_ec_calc_checksum(dout, dout_len);
132*4882a593Smuzhiyun out[3 + dout_len] = (uint8_t)csum;
133*4882a593Smuzhiyun
134*4882a593Smuzhiyun /*
135*4882a593Smuzhiyun * Send output data and receive input data starting such that the
136*4882a593Smuzhiyun * message body will be dword aligned.
137*4882a593Smuzhiyun */
138*4882a593Smuzhiyun p = dev->din + sizeof(int64_t) - 2;
139*4882a593Smuzhiyun len = dout_len + 4;
140*4882a593Smuzhiyun cros_ec_dump_data("out", cmd, out, len);
141*4882a593Smuzhiyun rv = spi_xfer(slave, max(len, in_bytes) * 8, out, p,
142*4882a593Smuzhiyun SPI_XFER_BEGIN | SPI_XFER_END);
143*4882a593Smuzhiyun
144*4882a593Smuzhiyun spi_release_bus(slave);
145*4882a593Smuzhiyun
146*4882a593Smuzhiyun if (rv) {
147*4882a593Smuzhiyun debug("%s: Cannot complete SPI transfer\n", __func__);
148*4882a593Smuzhiyun return -1;
149*4882a593Smuzhiyun }
150*4882a593Smuzhiyun
151*4882a593Smuzhiyun len = min((int)p[1], din_len);
152*4882a593Smuzhiyun cros_ec_dump_data("in", -1, p, len + 3);
153*4882a593Smuzhiyun
154*4882a593Smuzhiyun /* Response code is first byte of message */
155*4882a593Smuzhiyun if (p[0] != EC_RES_SUCCESS) {
156*4882a593Smuzhiyun printf("%s: Returned status %d\n", __func__, p[0]);
157*4882a593Smuzhiyun return -(int)(p[0]);
158*4882a593Smuzhiyun }
159*4882a593Smuzhiyun
160*4882a593Smuzhiyun /* Check checksum */
161*4882a593Smuzhiyun csum = cros_ec_calc_checksum(p, len + 2);
162*4882a593Smuzhiyun if (csum != p[len + 2]) {
163*4882a593Smuzhiyun debug("%s: Invalid checksum rx %#02x, calced %#02x\n", __func__,
164*4882a593Smuzhiyun p[2 + len], csum);
165*4882a593Smuzhiyun return -1;
166*4882a593Smuzhiyun }
167*4882a593Smuzhiyun
168*4882a593Smuzhiyun /* Anything else is the response data */
169*4882a593Smuzhiyun *dinp = p + 2;
170*4882a593Smuzhiyun
171*4882a593Smuzhiyun return len;
172*4882a593Smuzhiyun }
173*4882a593Smuzhiyun
cros_ec_probe(struct udevice * dev)174*4882a593Smuzhiyun static int cros_ec_probe(struct udevice *dev)
175*4882a593Smuzhiyun {
176*4882a593Smuzhiyun return cros_ec_register(dev);
177*4882a593Smuzhiyun }
178*4882a593Smuzhiyun
179*4882a593Smuzhiyun static struct dm_cros_ec_ops cros_ec_ops = {
180*4882a593Smuzhiyun .packet = cros_ec_spi_packet,
181*4882a593Smuzhiyun .command = cros_ec_spi_command,
182*4882a593Smuzhiyun };
183*4882a593Smuzhiyun
184*4882a593Smuzhiyun static const struct udevice_id cros_ec_ids[] = {
185*4882a593Smuzhiyun { .compatible = "google,cros-ec-spi" },
186*4882a593Smuzhiyun { }
187*4882a593Smuzhiyun };
188*4882a593Smuzhiyun
189*4882a593Smuzhiyun U_BOOT_DRIVER(cros_ec_spi) = {
190*4882a593Smuzhiyun .name = "cros_ec_spi",
191*4882a593Smuzhiyun .id = UCLASS_CROS_EC,
192*4882a593Smuzhiyun .of_match = cros_ec_ids,
193*4882a593Smuzhiyun .probe = cros_ec_probe,
194*4882a593Smuzhiyun .ops = &cros_ec_ops,
195*4882a593Smuzhiyun };
196