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_locked(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_locked(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_dev
->din_size
< EC_MSG_PREAMBLE_COUNT
);
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_dev
->din_size
< EC_MSG_PREAMBLE_COUNT
);
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_response
*response
;
370 struct cros_ec_spi
*ec_spi
= ec_dev
->priv
;
371 struct spi_transfer trans
, trans_delay
;
372 struct spi_message msg
;
377 int ret
= 0, final_ret
;
379 len
= cros_ec_prepare_tx(ec_dev
, ec_msg
);
380 dev_dbg(ec_dev
->dev
, "prepared, len=%d\n", len
);
382 /* If it's too soon to do another transaction, wait */
383 if (ec_spi
->last_transfer_ns
) {
384 unsigned long delay
; /* The delay completed so far */
386 delay
= ktime_get_ns() - ec_spi
->last_transfer_ns
;
387 if (delay
< EC_SPI_RECOVERY_TIME_NS
)
388 ndelay(EC_SPI_RECOVERY_TIME_NS
- delay
);
391 rx_buf
= kzalloc(len
, GFP_KERNEL
);
395 spi_bus_lock(ec_spi
->spi
->master
);
398 * Leave a gap between CS assertion and clocking of data to allow the
401 spi_message_init(&msg
);
402 if (ec_spi
->start_of_msg_delay
) {
403 memset(&trans_delay
, 0, sizeof(trans_delay
));
404 trans_delay
.delay_usecs
= ec_spi
->start_of_msg_delay
;
405 spi_message_add_tail(&trans_delay
, &msg
);
408 /* Transmit phase - send our message */
409 memset(&trans
, 0, sizeof(trans
));
410 trans
.tx_buf
= ec_dev
->dout
;
411 trans
.rx_buf
= rx_buf
;
414 spi_message_add_tail(&trans
, &msg
);
415 ret
= spi_sync_locked(ec_spi
->spi
, &msg
);
417 /* Get the response */
419 /* Verify that EC can process command */
420 for (i
= 0; i
< len
; i
++) {
422 case EC_SPI_PAST_END
:
423 case EC_SPI_RX_BAD_DATA
:
424 case EC_SPI_NOT_READY
:
426 ec_msg
->result
= EC_RES_IN_PROGRESS
;
434 ret
= cros_ec_spi_receive_packet(ec_dev
,
435 ec_msg
->insize
+ sizeof(*response
));
437 dev_err(ec_dev
->dev
, "spi transfer failed: %d\n", ret
);
440 final_ret
= terminate_request(ec_dev
);
442 spi_bus_unlock(ec_spi
->spi
->master
);
451 /* check response error code */
452 response
= (struct ec_host_response
*)ptr
;
453 ec_msg
->result
= response
->result
;
455 ret
= cros_ec_check_result(ec_dev
, ec_msg
);
459 len
= response
->data_len
;
461 if (len
> ec_msg
->insize
) {
462 dev_err(ec_dev
->dev
, "packet too long (%d bytes, expected %d)",
463 len
, ec_msg
->insize
);
468 for (i
= 0; i
< sizeof(*response
); i
++)
471 /* copy response packet payload and compute checksum */
472 memcpy(ec_msg
->data
, ptr
+ sizeof(*response
), len
);
473 for (i
= 0; i
< len
; i
++)
474 sum
+= ec_msg
->data
[i
];
478 "bad packet checksum, calculated %x\n",
487 if (ec_msg
->command
== EC_CMD_REBOOT_EC
)
488 msleep(EC_REBOOT_DELAY_MS
);
494 * cros_ec_cmd_xfer_spi - Transfer a message over SPI and receive the reply
496 * @ec_dev: ChromeOS EC device
497 * @ec_msg: Message to transfer
499 static int cros_ec_cmd_xfer_spi(struct cros_ec_device
*ec_dev
,
500 struct cros_ec_command
*ec_msg
)
502 struct cros_ec_spi
*ec_spi
= ec_dev
->priv
;
503 struct spi_transfer trans
;
504 struct spi_message msg
;
509 int ret
= 0, final_ret
;
511 len
= cros_ec_prepare_tx(ec_dev
, ec_msg
);
512 dev_dbg(ec_dev
->dev
, "prepared, len=%d\n", len
);
514 /* If it's too soon to do another transaction, wait */
515 if (ec_spi
->last_transfer_ns
) {
516 unsigned long delay
; /* The delay completed so far */
518 delay
= ktime_get_ns() - ec_spi
->last_transfer_ns
;
519 if (delay
< EC_SPI_RECOVERY_TIME_NS
)
520 ndelay(EC_SPI_RECOVERY_TIME_NS
- delay
);
523 rx_buf
= kzalloc(len
, GFP_KERNEL
);
527 spi_bus_lock(ec_spi
->spi
->master
);
529 /* Transmit phase - send our message */
530 debug_packet(ec_dev
->dev
, "out", ec_dev
->dout
, len
);
531 memset(&trans
, 0, sizeof(trans
));
532 trans
.tx_buf
= ec_dev
->dout
;
533 trans
.rx_buf
= rx_buf
;
536 spi_message_init(&msg
);
537 spi_message_add_tail(&trans
, &msg
);
538 ret
= spi_sync_locked(ec_spi
->spi
, &msg
);
540 /* Get the response */
542 /* Verify that EC can process command */
543 for (i
= 0; i
< len
; i
++) {
545 case EC_SPI_PAST_END
:
546 case EC_SPI_RX_BAD_DATA
:
547 case EC_SPI_NOT_READY
:
549 ec_msg
->result
= EC_RES_IN_PROGRESS
;
557 ret
= cros_ec_spi_receive_response(ec_dev
,
558 ec_msg
->insize
+ EC_MSG_TX_PROTO_BYTES
);
560 dev_err(ec_dev
->dev
, "spi transfer failed: %d\n", ret
);
563 final_ret
= terminate_request(ec_dev
);
565 spi_bus_unlock(ec_spi
->spi
->master
);
574 /* check response error code */
575 ec_msg
->result
= ptr
[0];
576 ret
= cros_ec_check_result(ec_dev
, ec_msg
);
581 sum
= ptr
[0] + ptr
[1];
582 if (len
> ec_msg
->insize
) {
583 dev_err(ec_dev
->dev
, "packet too long (%d bytes, expected %d)",
584 len
, ec_msg
->insize
);
589 /* copy response packet payload and compute checksum */
590 for (i
= 0; i
< len
; i
++) {
593 ec_msg
->data
[i
] = ptr
[i
+ 2];
597 debug_packet(ec_dev
->dev
, "in", ptr
, len
+ 3);
599 if (sum
!= ptr
[len
+ 2]) {
601 "bad packet checksum, expected %02x, got %02x\n",
610 if (ec_msg
->command
== EC_CMD_REBOOT_EC
)
611 msleep(EC_REBOOT_DELAY_MS
);
616 static void cros_ec_spi_dt_probe(struct cros_ec_spi
*ec_spi
, struct device
*dev
)
618 struct device_node
*np
= dev
->of_node
;
622 ret
= of_property_read_u32(np
, "google,cros-ec-spi-pre-delay", &val
);
624 ec_spi
->start_of_msg_delay
= val
;
626 ret
= of_property_read_u32(np
, "google,cros-ec-spi-msg-delay", &val
);
628 ec_spi
->end_of_msg_delay
= val
;
631 static int cros_ec_spi_probe(struct spi_device
*spi
)
633 struct device
*dev
= &spi
->dev
;
634 struct cros_ec_device
*ec_dev
;
635 struct cros_ec_spi
*ec_spi
;
638 spi
->bits_per_word
= 8;
639 spi
->mode
= SPI_MODE_0
;
640 err
= spi_setup(spi
);
644 ec_spi
= devm_kzalloc(dev
, sizeof(*ec_spi
), GFP_KERNEL
);
648 ec_dev
= devm_kzalloc(dev
, sizeof(*ec_dev
), GFP_KERNEL
);
652 /* Check for any DT properties */
653 cros_ec_spi_dt_probe(ec_spi
, dev
);
655 spi_set_drvdata(spi
, ec_dev
);
657 ec_dev
->priv
= ec_spi
;
658 ec_dev
->irq
= spi
->irq
;
659 ec_dev
->cmd_xfer
= cros_ec_cmd_xfer_spi
;
660 ec_dev
->pkt_xfer
= cros_ec_pkt_xfer_spi
;
661 ec_dev
->phys_name
= dev_name(&ec_spi
->spi
->dev
);
662 ec_dev
->din_size
= EC_MSG_PREAMBLE_COUNT
+
663 sizeof(struct ec_host_response
) +
664 sizeof(struct ec_response_get_protocol_info
);
665 ec_dev
->dout_size
= sizeof(struct ec_host_request
);
668 err
= cros_ec_register(ec_dev
);
670 dev_err(dev
, "cannot register EC\n");
674 device_init_wakeup(&spi
->dev
, true);
679 static int cros_ec_spi_remove(struct spi_device
*spi
)
681 struct cros_ec_device
*ec_dev
;
683 ec_dev
= spi_get_drvdata(spi
);
684 cros_ec_remove(ec_dev
);
689 #ifdef CONFIG_PM_SLEEP
690 static int cros_ec_spi_suspend(struct device
*dev
)
692 struct cros_ec_device
*ec_dev
= dev_get_drvdata(dev
);
694 return cros_ec_suspend(ec_dev
);
697 static int cros_ec_spi_resume(struct device
*dev
)
699 struct cros_ec_device
*ec_dev
= dev_get_drvdata(dev
);
701 return cros_ec_resume(ec_dev
);
705 static SIMPLE_DEV_PM_OPS(cros_ec_spi_pm_ops
, cros_ec_spi_suspend
,
708 static const struct of_device_id cros_ec_spi_of_match
[] = {
709 { .compatible
= "google,cros-ec-spi", },
712 MODULE_DEVICE_TABLE(of
, cros_ec_spi_of_match
);
714 static const struct spi_device_id cros_ec_spi_id
[] = {
715 { "cros-ec-spi", 0 },
718 MODULE_DEVICE_TABLE(spi
, cros_ec_spi_id
);
720 static struct spi_driver cros_ec_driver_spi
= {
722 .name
= "cros-ec-spi",
723 .of_match_table
= of_match_ptr(cros_ec_spi_of_match
),
724 .pm
= &cros_ec_spi_pm_ops
,
726 .probe
= cros_ec_spi_probe
,
727 .remove
= cros_ec_spi_remove
,
728 .id_table
= cros_ec_spi_id
,
731 module_spi_driver(cros_ec_driver_spi
);
733 MODULE_LICENSE("GPL v2");
734 MODULE_DESCRIPTION("ChromeOS EC multi function device (SPI)");