1.. _tcan4550evm_shield:
2
3Texas Instruments TCAN4550EVM
4#############################
5
6Overview
7********
8
9The Texas Instruments `TCAN4550EVM`_ features a `TI TCAN4550-Q1`_ automotive system basis chip (SBC)
10with integrated CAN FD controller & transceiver.
11
12.. figure:: tcan4550evm.jpg
13   :align: center
14   :alt: TCAN4550EVM
15
16   TCAN4550EVM (Credit: Texas Instruments)
17
18Requirements
19************
20
21This shield can only be used with a board which provides a configuration for Arduino connectors and
22defines node aliases for SPI and GPIO interfaces (see :ref:`shields` for more details).
23
24.. note::
25
26    This shield configuration limits the maximum SPI clock frequency to 2MHz although the
27    TCAN4550-Q1 supports up to 18MHz SPI clock frequency. This is done to accommodate the flywires
28    usually used for connecting the TCAN4550EVM to the board running Zephyr.
29
30Pin Assignments
31===============
32
33+-----------------------+---------------------------------------------+
34| Shield Connector Pin  | Function                                    |
35+=======================+=============================================+
36| D6                    | nWKRQ                                       |
37+-----------------------+---------------------------------------------+
38| D7                    | WAKE_LV                                     |
39+-----------------------+---------------------------------------------+
40| D8                    | RESET                                       |
41+-----------------------+---------------------------------------------+
42| D9                    | nINT                                        |
43+-----------------------+---------------------------------------------+
44| D10                   | nCS                                         |
45+-----------------------+---------------------------------------------+
46| D11                   | SDI                                         |
47+-----------------------+---------------------------------------------+
48| D12                   | SDO                                         |
49+-----------------------+---------------------------------------------+
50| D13                   | SCLK                                        |
51+-----------------------+---------------------------------------------+
52
53Programming
54***********
55
56Set ``-DSHIELD=tcan4550evm`` when you invoke ``west build``. For example:
57
58.. zephyr-app-commands::
59   :zephyr-app: tests/drivers/can/api
60   :board: frdm_k64f
61   :shield: tcan4550evm
62   :goals: build
63
64.. _TCAN4550EVM:
65   https://www.ti.com/tool/TCAN4550EVM
66
67.. _TI TCAN4550-Q1:
68   https://www.ti.com/product/TCAN4550-Q1
69