2 * ChromeOS EC multi-function device (SPI)
4 * Copyright (C) 2012 Google, Inc
6 * This software is licensed under the terms of the GNU General Public
7 * License version 2, as published by the Free Software Foundation, and
8 * may be copied, distributed, and modified under those terms.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
16 #include <linux/delay.h>
17 #include <linux/kernel.h>
18 #include <linux/module.h>
19 #include <linux/mfd/cros_ec.h>
20 #include <linux/mfd/cros_ec_commands.h>
22 #include <linux/platform_device.h>
23 #include <linux/slab.h>
24 #include <linux/spi/spi.h>
27 /* The header byte, which follows the preamble */
28 #define EC_MSG_HEADER 0xec
31 * Number of EC preamble bytes we read at a time. Since it takes
32 * about 400-500us for the EC to respond there is not a lot of
33 * point in tuning this. If the EC could respond faster then
34 * we could increase this so that might expect the preamble and
35 * message to occur in a single transaction. However, the maximum
36 * SPI transfer size is 256 bytes, so at 5MHz we need a response
37 * time of perhaps <320us (200 bytes / 1600 bits).
39 #define EC_MSG_PREAMBLE_COUNT 32
42 * Allow for a long time for the EC to respond. We support i2c
43 * tunneling and support fairly long messages for the tunnel (249
44 * bytes long at the moment). If we're talking to a 100 kHz device
45 * on the other end and need to transfer ~256 bytes, then we need:
46 * 10 us/bit * ~10 bits/byte * ~256 bytes = ~25ms
48 * We'll wait 4 times that to handle clock stretching and other
51 * It's pretty unlikely that we'll really see a 249 byte tunnel in
52 * anything other than testing. If this was more common we might
53 * consider having slow commands like this require a GET_STATUS
54 * wait loop. The 'flash write' command would be another candidate
55 * for this, clocking in at 2-3ms.
57 #define EC_MSG_DEADLINE_MS 100
60 * Time between raising the SPI chip select (for the end of a
61 * transaction) and dropping it again (for the next transaction).
62 * If we go too fast, the EC will miss the transaction. We know that we
63 * need at least 70 us with the 16 MHz STM32 EC, so go with 200 us to be
66 #define EC_SPI_RECOVERY_TIME_NS (200 * 1000)
69 * struct cros_ec_spi - information about a SPI-connected EC
71 * @spi: SPI device we are connected to
72 * @last_transfer_ns: time that we last finished a transfer, or 0 if there
74 * @start_of_msg_delay: used to set the delay_usecs on the spi_transfer that
75 * is sent when we want to turn on CS at the start of a transaction.
76 * @end_of_msg_delay: used to set the delay_usecs on the spi_transfer that
77 * is sent when we want to turn off CS at the end of a transaction.
80 struct spi_device
*spi
;
82 unsigned int start_of_msg_delay
;
83 unsigned int end_of_msg_delay
;
86 static void debug_packet(struct device
*dev
, const char *name
, u8
*ptr
,
92 dev_dbg(dev
, "%s: ", name
);
93 for (i
= 0; i
< len
; i
++)
94 pr_cont(" %02x", ptr
[i
]);
100 static int terminate_request(struct cros_ec_device
*ec_dev
)
102 struct cros_ec_spi
*ec_spi
= ec_dev
->priv
;
103 struct spi_message msg
;
104 struct spi_transfer trans
;
108 * Turn off CS, possibly adding a delay to ensure the rising edge
109 * doesn't come too soon after the end of the data.
111 spi_message_init(&msg
);
112 memset(&trans
, 0, sizeof(trans
));
113 trans
.delay_usecs
= ec_spi
->end_of_msg_delay
;
114 spi_message_add_tail(&trans
, &msg
);
116 ret
= spi_sync(ec_spi
->spi
, &msg
);
118 /* Reset end-of-response timer */
119 ec_spi
->last_transfer_ns
= ktime_get_ns();
122 "cs-deassert spi transfer failed: %d\n",
130 * receive_n_bytes - receive n bytes from the EC.
132 * Assumes buf is a pointer into the ec_dev->din buffer
134 static int receive_n_bytes(struct cros_ec_device
*ec_dev
, u8
*buf
, int n
)
136 struct cros_ec_spi
*ec_spi
= ec_dev
->priv
;
137 struct spi_transfer trans
;
138 struct spi_message msg
;
141 BUG_ON(buf
- ec_dev
->din
+ n
> ec_dev
->din_size
);
143 memset(&trans
, 0, sizeof(trans
));
148 spi_message_init(&msg
);
149 spi_message_add_tail(&trans
, &msg
);
150 ret
= spi_sync(ec_spi
->spi
, &msg
);
152 dev_err(ec_dev
->dev
, "spi transfer failed: %d\n", ret
);
158 * cros_ec_spi_receive_packet - Receive a packet from the EC.
160 * This function has two phases: reading the preamble bytes (since if we read
161 * data from the EC before it is ready to send, we just get preamble) and
162 * reading the actual message.
164 * The received data is placed into ec_dev->din.
166 * @ec_dev: ChromeOS EC device
167 * @need_len: Number of message bytes we need to read
169 static int cros_ec_spi_receive_packet(struct cros_ec_device
*ec_dev
,
172 struct ec_host_response
*response
;
175 unsigned long deadline
;
178 BUG_ON(EC_MSG_PREAMBLE_COUNT
> ec_dev
->din_size
);
180 /* Receive data until we see the header byte */
181 deadline
= jiffies
+ msecs_to_jiffies(EC_MSG_DEADLINE_MS
);
183 unsigned long start_jiffies
= jiffies
;
185 ret
= receive_n_bytes(ec_dev
,
187 EC_MSG_PREAMBLE_COUNT
);
192 for (end
= ptr
+ EC_MSG_PREAMBLE_COUNT
; ptr
!= end
; ptr
++) {
193 if (*ptr
== EC_SPI_FRAME_START
) {
194 dev_dbg(ec_dev
->dev
, "msg found at %zd\n",
203 * Use the time at the start of the loop as a timeout. This
204 * gives us one last shot at getting the transfer and is useful
205 * in case we got context switched out for a while.
207 if (time_after(start_jiffies
, deadline
)) {
208 dev_warn(ec_dev
->dev
, "EC failed to respond in time\n");
214 * ptr now points to the header byte. Copy any valid data to the
215 * start of our buffer
218 BUG_ON(todo
< 0 || todo
> ec_dev
->din_size
);
219 todo
= min(todo
, need_len
);
220 memmove(ec_dev
->din
, ptr
, todo
);
221 ptr
= ec_dev
->din
+ todo
;
222 dev_dbg(ec_dev
->dev
, "need %d, got %d bytes from preamble\n",
226 /* If the entire response struct wasn't read, get the rest of it. */
227 if (todo
< sizeof(*response
)) {
228 ret
= receive_n_bytes(ec_dev
, ptr
, sizeof(*response
) - todo
);
231 ptr
+= (sizeof(*response
) - todo
);
232 todo
= sizeof(*response
);
235 response
= (struct ec_host_response
*)ec_dev
->din
;
237 /* Abort if data_len is too large. */
238 if (response
->data_len
> ec_dev
->din_size
)
241 /* Receive data until we have it all */
242 while (need_len
> 0) {
244 * We can't support transfers larger than the SPI FIFO size
245 * unless we have DMA. We don't have DMA on the ISP SPI ports
246 * for Exynos. We need a way of asking SPI driver for
247 * maximum-supported transfer size.
249 todo
= min(need_len
, 256);
250 dev_dbg(ec_dev
->dev
, "loop, todo=%d, need_len=%d, ptr=%zd\n",
251 todo
, need_len
, ptr
- ec_dev
->din
);
253 ret
= receive_n_bytes(ec_dev
, ptr
, todo
);
261 dev_dbg(ec_dev
->dev
, "loop done, ptr=%zd\n", ptr
- ec_dev
->din
);
267 * cros_ec_spi_receive_response - Receive a response from the EC.
269 * This function has two phases: reading the preamble bytes (since if we read
270 * data from the EC before it is ready to send, we just get preamble) and
271 * reading the actual message.
273 * The received data is placed into ec_dev->din.
275 * @ec_dev: ChromeOS EC device
276 * @need_len: Number of message bytes we need to read
278 static int cros_ec_spi_receive_response(struct cros_ec_device
*ec_dev
,
283 unsigned long deadline
;
286 BUG_ON(EC_MSG_PREAMBLE_COUNT
> ec_dev
->din_size
);
288 /* Receive data until we see the header byte */
289 deadline
= jiffies
+ msecs_to_jiffies(EC_MSG_DEADLINE_MS
);
291 unsigned long start_jiffies
= jiffies
;
293 ret
= receive_n_bytes(ec_dev
,
295 EC_MSG_PREAMBLE_COUNT
);
300 for (end
= ptr
+ EC_MSG_PREAMBLE_COUNT
; ptr
!= end
; ptr
++) {
301 if (*ptr
== EC_SPI_FRAME_START
) {
302 dev_dbg(ec_dev
->dev
, "msg found at %zd\n",
311 * Use the time at the start of the loop as a timeout. This
312 * gives us one last shot at getting the transfer and is useful
313 * in case we got context switched out for a while.
315 if (time_after(start_jiffies
, deadline
)) {
316 dev_warn(ec_dev
->dev
, "EC failed to respond in time\n");
322 * ptr now points to the header byte. Copy any valid data to the
323 * start of our buffer
326 BUG_ON(todo
< 0 || todo
> ec_dev
->din_size
);
327 todo
= min(todo
, need_len
);
328 memmove(ec_dev
->din
, ptr
, todo
);
329 ptr
= ec_dev
->din
+ todo
;
330 dev_dbg(ec_dev
->dev
, "need %d, got %d bytes from preamble\n",
334 /* Receive data until we have it all */
335 while (need_len
> 0) {
337 * We can't support transfers larger than the SPI FIFO size
338 * unless we have DMA. We don't have DMA on the ISP SPI ports
339 * for Exynos. We need a way of asking SPI driver for
340 * maximum-supported transfer size.
342 todo
= min(need_len
, 256);
343 dev_dbg(ec_dev
->dev
, "loop, todo=%d, need_len=%d, ptr=%zd\n",
344 todo
, need_len
, ptr
- ec_dev
->din
);
346 ret
= receive_n_bytes(ec_dev
, ptr
, todo
);
350 debug_packet(ec_dev
->dev
, "interim", ptr
, todo
);
355 dev_dbg(ec_dev
->dev
, "loop done, ptr=%zd\n", ptr
- ec_dev
->din
);
361 * cros_ec_pkt_xfer_spi - Transfer a packet over SPI and receive the reply
363 * @ec_dev: ChromeOS EC device
364 * @ec_msg: Message to transfer
366 static int cros_ec_pkt_xfer_spi(struct cros_ec_device
*ec_dev
,
367 struct cros_ec_command
*ec_msg
)
369 struct ec_host_request
*request
;
370 struct ec_host_response
*response
;
371 struct cros_ec_spi
*ec_spi
= ec_dev
->priv
;
372 struct spi_transfer trans
, trans_delay
;
373 struct spi_message msg
;
378 int ret
= 0, final_ret
;
380 len
= cros_ec_prepare_tx(ec_dev
, ec_msg
);
381 request
= (struct ec_host_request
*)ec_dev
->dout
;
382 dev_dbg(ec_dev
->dev
, "prepared, len=%d\n", len
);
384 /* If it's too soon to do another transaction, wait */
385 if (ec_spi
->last_transfer_ns
) {
386 unsigned long delay
; /* The delay completed so far */
388 delay
= ktime_get_ns() - ec_spi
->last_transfer_ns
;
389 if (delay
< EC_SPI_RECOVERY_TIME_NS
)
390 ndelay(EC_SPI_RECOVERY_TIME_NS
- delay
);
393 rx_buf
= kzalloc(len
, GFP_KERNEL
);
400 * Leave a gap between CS assertion and clocking of data to allow the
403 spi_message_init(&msg
);
404 if (ec_spi
->start_of_msg_delay
) {
405 memset(&trans_delay
, 0, sizeof(trans_delay
));
406 trans_delay
.delay_usecs
= ec_spi
->start_of_msg_delay
;
407 spi_message_add_tail(&trans_delay
, &msg
);
410 /* Transmit phase - send our message */
411 memset(&trans
, 0, sizeof(trans
));
412 trans
.tx_buf
= ec_dev
->dout
;
413 trans
.rx_buf
= rx_buf
;
416 spi_message_add_tail(&trans
, &msg
);
417 ret
= spi_sync(ec_spi
->spi
, &msg
);
419 /* Get the response */
421 /* Verify that EC can process command */
422 for (i
= 0; i
< len
; i
++) {
424 case EC_SPI_PAST_END
:
425 case EC_SPI_RX_BAD_DATA
:
426 case EC_SPI_NOT_READY
:
428 ec_msg
->result
= EC_RES_IN_PROGRESS
;
436 ret
= cros_ec_spi_receive_packet(ec_dev
,
437 ec_msg
->insize
+ sizeof(*response
));
439 dev_err(ec_dev
->dev
, "spi transfer failed: %d\n", ret
);
442 final_ret
= terminate_request(ec_dev
);
450 /* check response error code */
451 response
= (struct ec_host_response
*)ptr
;
452 ec_msg
->result
= response
->result
;
454 ret
= cros_ec_check_result(ec_dev
, ec_msg
);
458 len
= response
->data_len
;
460 if (len
> ec_msg
->insize
) {
461 dev_err(ec_dev
->dev
, "packet too long (%d bytes, expected %d)",
462 len
, ec_msg
->insize
);
467 for (i
= 0; i
< sizeof(*response
); i
++)
470 /* copy response packet payload and compute checksum */
471 memcpy(ec_msg
->data
, ptr
+ sizeof(*response
), len
);
472 for (i
= 0; i
< len
; i
++)
473 sum
+= ec_msg
->data
[i
];
477 "bad packet checksum, calculated %x\n",
486 if (ec_msg
->command
== EC_CMD_REBOOT_EC
)
487 msleep(EC_REBOOT_DELAY_MS
);
493 * cros_ec_cmd_xfer_spi - Transfer a message over SPI and receive the reply
495 * @ec_dev: ChromeOS EC device
496 * @ec_msg: Message to transfer
498 static int cros_ec_cmd_xfer_spi(struct cros_ec_device
*ec_dev
,
499 struct cros_ec_command
*ec_msg
)
501 struct cros_ec_spi
*ec_spi
= ec_dev
->priv
;
502 struct spi_transfer trans
;
503 struct spi_message msg
;
508 int ret
= 0, final_ret
;
510 len
= cros_ec_prepare_tx(ec_dev
, ec_msg
);
511 dev_dbg(ec_dev
->dev
, "prepared, len=%d\n", len
);
513 /* If it's too soon to do another transaction, wait */
514 if (ec_spi
->last_transfer_ns
) {
515 unsigned long delay
; /* The delay completed so far */
517 delay
= ktime_get_ns() - ec_spi
->last_transfer_ns
;
518 if (delay
< EC_SPI_RECOVERY_TIME_NS
)
519 ndelay(EC_SPI_RECOVERY_TIME_NS
- delay
);
522 rx_buf
= kzalloc(len
, GFP_KERNEL
);
528 /* Transmit phase - send our message */
529 debug_packet(ec_dev
->dev
, "out", ec_dev
->dout
, len
);
530 memset(&trans
, 0, sizeof(trans
));
531 trans
.tx_buf
= ec_dev
->dout
;
532 trans
.rx_buf
= rx_buf
;
535 spi_message_init(&msg
);
536 spi_message_add_tail(&trans
, &msg
);
537 ret
= spi_sync(ec_spi
->spi
, &msg
);
539 /* Get the response */
541 /* Verify that EC can process command */
542 for (i
= 0; i
< len
; i
++) {
544 case EC_SPI_PAST_END
:
545 case EC_SPI_RX_BAD_DATA
:
546 case EC_SPI_NOT_READY
:
548 ec_msg
->result
= EC_RES_IN_PROGRESS
;
556 ret
= cros_ec_spi_receive_response(ec_dev
,
557 ec_msg
->insize
+ EC_MSG_TX_PROTO_BYTES
);
559 dev_err(ec_dev
->dev
, "spi transfer failed: %d\n", ret
);
562 final_ret
= terminate_request(ec_dev
);
570 /* check response error code */
571 ec_msg
->result
= ptr
[0];
572 ret
= cros_ec_check_result(ec_dev
, ec_msg
);
577 sum
= ptr
[0] + ptr
[1];
578 if (len
> ec_msg
->insize
) {
579 dev_err(ec_dev
->dev
, "packet too long (%d bytes, expected %d)",
580 len
, ec_msg
->insize
);
585 /* copy response packet payload and compute checksum */
586 for (i
= 0; i
< len
; i
++) {
589 ec_msg
->data
[i
] = ptr
[i
+ 2];
593 debug_packet(ec_dev
->dev
, "in", ptr
, len
+ 3);
595 if (sum
!= ptr
[len
+ 2]) {
597 "bad packet checksum, expected %02x, got %02x\n",
606 if (ec_msg
->command
== EC_CMD_REBOOT_EC
)
607 msleep(EC_REBOOT_DELAY_MS
);
612 static void cros_ec_spi_dt_probe(struct cros_ec_spi
*ec_spi
, struct device
*dev
)
614 struct device_node
*np
= dev
->of_node
;
618 ret
= of_property_read_u32(np
, "google,cros-ec-spi-pre-delay", &val
);
620 ec_spi
->start_of_msg_delay
= val
;
622 ret
= of_property_read_u32(np
, "google,cros-ec-spi-msg-delay", &val
);
624 ec_spi
->end_of_msg_delay
= val
;
627 static int cros_ec_spi_probe(struct spi_device
*spi
)
629 struct device
*dev
= &spi
->dev
;
630 struct cros_ec_device
*ec_dev
;
631 struct cros_ec_spi
*ec_spi
;
634 spi
->bits_per_word
= 8;
635 spi
->mode
= SPI_MODE_0
;
636 err
= spi_setup(spi
);
640 ec_spi
= devm_kzalloc(dev
, sizeof(*ec_spi
), GFP_KERNEL
);
644 ec_dev
= devm_kzalloc(dev
, sizeof(*ec_dev
), GFP_KERNEL
);
648 /* Check for any DT properties */
649 cros_ec_spi_dt_probe(ec_spi
, dev
);
651 spi_set_drvdata(spi
, ec_dev
);
653 ec_dev
->priv
= ec_spi
;
654 ec_dev
->irq
= spi
->irq
;
655 ec_dev
->cmd_xfer
= cros_ec_cmd_xfer_spi
;
656 ec_dev
->pkt_xfer
= cros_ec_pkt_xfer_spi
;
657 ec_dev
->phys_name
= dev_name(&ec_spi
->spi
->dev
);
658 ec_dev
->din_size
= EC_MSG_PREAMBLE_COUNT
+
659 sizeof(struct ec_host_response
) +
660 sizeof(struct ec_response_get_protocol_info
);
661 ec_dev
->dout_size
= sizeof(struct ec_host_request
);
663 ec_spi
->last_transfer_ns
= ktime_get_ns();
665 err
= cros_ec_register(ec_dev
);
667 dev_err(dev
, "cannot register EC\n");
671 device_init_wakeup(&spi
->dev
, true);
676 static int cros_ec_spi_remove(struct spi_device
*spi
)
678 struct cros_ec_device
*ec_dev
;
680 ec_dev
= spi_get_drvdata(spi
);
681 cros_ec_remove(ec_dev
);
686 #ifdef CONFIG_PM_SLEEP
687 static int cros_ec_spi_suspend(struct device
*dev
)
689 struct cros_ec_device
*ec_dev
= dev_get_drvdata(dev
);
691 return cros_ec_suspend(ec_dev
);
694 static int cros_ec_spi_resume(struct device
*dev
)
696 struct cros_ec_device
*ec_dev
= dev_get_drvdata(dev
);
698 return cros_ec_resume(ec_dev
);
702 static SIMPLE_DEV_PM_OPS(cros_ec_spi_pm_ops
, cros_ec_spi_suspend
,
705 static const struct of_device_id cros_ec_spi_of_match
[] = {
706 { .compatible
= "google,cros-ec-spi", },
709 MODULE_DEVICE_TABLE(of
, cros_ec_spi_of_match
);
711 static const struct spi_device_id cros_ec_spi_id
[] = {
712 { "cros-ec-spi", 0 },
715 MODULE_DEVICE_TABLE(spi
, cros_ec_spi_id
);
717 static struct spi_driver cros_ec_driver_spi
= {
719 .name
= "cros-ec-spi",
720 .of_match_table
= of_match_ptr(cros_ec_spi_of_match
),
721 .pm
= &cros_ec_spi_pm_ops
,
723 .probe
= cros_ec_spi_probe
,
724 .remove
= cros_ec_spi_remove
,
725 .id_table
= cros_ec_spi_id
,
728 module_spi_driver(cros_ec_driver_spi
);
730 MODULE_LICENSE("GPL v2");
731 MODULE_DESCRIPTION("ChromeOS EC multi function device (SPI)");