1.. _rcar_h3_salvatorx_boards:
2
3Renesas R-Car H3 Salvator-X
4###########################
5
6Overview
7********
8- The H3 Salvator-X board is designed for evaluating the features and performance
9  of the R-CAR H3 device from Renesas Electronics and it is also used for developing
10  and evaluating application software for these R-CAR H3.
11
12- The H3 Salvator-X, based on the R-CAR H3 SIP, comes with LPDDR4 @4GB in 2-channel,
13  each 64-bit wide+Hyperflash @64MB, CSI2 interfaces and several communication interfaces
14  like USB, Ethernet, HDMI and can work standalone or can be adapted to other boards,
15  via 440pin connector on bottom side.
16
17.. figure:: img/rcar_h3_salvatorx.jpg
18   :align: center
19   :alt: R-Car Salvator-X kit
20
21More information about the board can be found at `Renesas R-Car Development Support website`_.
22
23Hardware
24********
25
26Hardware capabilities for the H3 Salvator-X for can be found on the `eLinux H3 Salvator-X page`_
27of the board.
28
29.. figure:: img/rcar_h3_features.jpg
30   :align: center
31   :alt: R-Car Salvator-X features
32
33.. note:: Zephyr will be booted on the CR7 processor provided for RTOS purpose.
34
35More information about the SoC that equips the board can be found here:
36
37- `Renesas R-Car H3 chip`_
38
39Supported Features
40==================
41
42Here is the current supported features when running Zephyr Project on the R-Car Salvator-X CR7:
43
44+-----------+------------------------------+--------------------------------+
45| Interface | Driver/components            | Support level                  |
46+===========+==============================+================================+
47| PINCTRL   | pinctrl                      |                                |
48+-----------+------------------------------+--------------------------------+
49| CLOCK     | clock_control                |                                |
50+-----------+------------------------------+--------------------------------+
51| GPIO      | gpio                         |                                |
52+-----------+------------------------------+--------------------------------+
53| UART      | uart                         | serial port-polling            |
54+           +                              +                                +
55|           | FT232RQ / CP2102             | serial port-interrupt          |
56+-----------+------------------------------+--------------------------------+
57| CAN       | can                          | normal mode                    |
58+           +                              +                                +
59|           | TCAN332GDCNT                 | loopback mode                  |
60+-----------+------------------------------+--------------------------------+
61| I2C       | i2c                          | interrupt driven               |
62+-----------+------------------------------+--------------------------------+
63
64It's also currently possible to write on the ram console.
65
66Connections and IOs
67===================
68
69.. figure:: img/r-car-h3-salvator-x-connections.jpg
70   :align: center
71   :alt: R-Car Salvator-X connections
72
73GPIO
74----
75
76By running Zephyr on H3 Salvator-X, the software readable push buttons 'SW20',
77'SW21', 'SW22' can be used as input, and the software contollable LEDs 'LED4',
78'LED5', 'LED6' can be used as output.
79
80UART
81----
82
83Salvator-X board is providing two serial ports:
84
85- one is for A53/A57 processors
86- the other one is for CR7
87
88Both ports are converted to USB through CP2102 converters and they are exposed
89as follows:
90
91+-----------+-----------+
92| Connector | Processor |
93+===========+===========+
94| CN25      | A53/A57   |
95+-----------+-----------+
96| CN26      | CR7       |
97+-----------+-----------+
98
99Programming and Debugging
100*************************
101
102Build and flash applications as usual (see :ref:`build_an_application` and
103:ref:`application_run` for more details).
104
105Supported Debug Probe
106=====================
107
108The "Olimex ARM-USB-OCD-H" probe is the only officially supported probe. This
109probe is supported by OpenOCD that is shipped with the Zephyr SDK.
110
111The "Olimex ARM-USB-OCD-H" probe needs to be connected to CN1 on Salvator-X.
112
113Configuring a Console
114=====================
115
116Connect a USB cable from your PC to CN25 and/or CN26 then use the following
117settings with your serial terminal of choice (minicom, putty,
118etc.):
119
120- Speed: 115200
121- Data: 8 bits
122- Parity: None
123- Stop bits: 1
124
125Flashing
126========
127
128First of all, open your serial terminal.
129
130Applications for the ``rcar_salvator_x`` board configuration can be built
131in the usual way (see :ref:`build_an_application` for more details).
132
133.. zephyr-app-commands::
134   :zephyr-app: samples/hello_world
135   :board: rcar_salvator_x
136   :goals: flash
137
138You should see the following message in the terminal:
139
140.. code-block:: console
141
142	*** Booting Zephyr OS build v2.6.0-rc1 ***
143	Hello World! rcar_salvator_x
144
145Debugging
146=========
147
148First of all, open your serial terminal.
149
150Here is an example for the :zephyr:code-sample:`hello_world` application.
151
152.. zephyr-app-commands::
153   :zephyr-app: samples/hello_world
154   :board: rcar_salvator_x
155   :goals: debug
156
157You will then get access to a GDB session for debug.
158
159By continuing the app, you should see the following message in the terminal:
160
161.. code-block:: console
162
163	*** Booting Zephyr OS build v2.6.0-rc1 ***
164	Hello World! rcar_salvator_x
165
166References
167**********
168
169- `Renesas R-Car H3 chip`_
170- `Renesas R-Car Development Support website`_
171- `eLinux H3 Salvator-X page`_
172
173.. _Renesas R-Car H3 chip:
174	https://www.renesas.com/eu/en/products/automotive-products/automotive-system-chips-socs/r-car-h3-high-end-automotive-system-chip-soc-vehicle-infotainment-and-driving-safety-support
175
176.. _Renesas R-Car Development Support website:
177   https://www.renesas.com/us/en/support/partners/r-car-consortium/r-car-development-support
178
179.. _eLinux H3 Salvator-X page:
180	https://elinux.org/R-Car/Boards/Salvator-X
181
182.. _Install a toolchain:
183	https://docs.zephyrproject.org/latest/getting_started/index.html#install-a-toolchain
184