boards/renesas/rcar_salvator_x/doc/index.rst
.. zephyr:board:: rcar_salvator_x
Overview
The H3 Salvator-X board is designed for evaluating the features and performance of the R-CAR H3 device from Renesas Electronics and it is also used for developing and evaluating application software for these R-CAR H3.
The H3 Salvator-X, based on the R-CAR H3 SIP, comes with LPDDR4 @4GB in 2-channel, each 64-bit wide+Hyperflash @64MB, CSI2 interfaces and several communication interfaces like USB, Ethernet, HDMI and can work standalone or can be adapted to other boards, via 440pin connector on bottom side.
More information about the H3 SoC can be found here: Renesas R-Car H3 chip_
Hardware
Hardware capabilities for the H3 Salvator-X for can be found on the eLinux H3 Salvator-X page_.
.. note:: Zephyr will be booted on the CR7 processor provided for RTOS purpose.
More information about the board can be found at Renesas R-Car Development Support website_.
.. zephyr:board-supported-hw::
.. note::
It is recommended to disable peripherals used by the R7 core on the Linux host.
.. figure:: img/r-car-h3-salvator-x-connections.jpg :align: center :alt: R-Car Salvator-X connections
By running Zephyr on H3 Salvator-X, the software readable push buttons 'SW20', 'SW21', 'SW22' can be used as input, and the software contollable LEDs 'LED4', 'LED5', 'LED6' can be used as output.
Salvator-X board is providing two serial ports:
Both ports are converted to USB through CP2102 converters and they are exposed as follows:
+-----------+-----------+ | Connector | Processor | +===========+===========+ | CN25 | A53/A57 | +-----------+-----------+ | CN26 | CR7 | +-----------+-----------+
Programming and Debugging
.. zephyr:board-supported-runners::
Build and flash applications as usual (see :ref:build_an_application and
:ref:application_run for more details).
The "Olimex ARM-USB-OCD-H" probe is the only officially supported probe. This probe is supported by OpenOCD that is shipped with the Zephyr SDK.
The "Olimex ARM-USB-OCD-H" probe needs to be connected to CN1 on Salvator-X.
Connect a USB cable from your PC to CN25 and/or CN26 then use the following settings with your serial terminal of choice (minicom, putty, etc.):
First of all, open your serial terminal.
Applications for the rcar_salvator_x board configuration can be built
in the usual way (see :ref:build_an_application for more details).
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: rcar_salvator_x :goals: flash
You should see the following message in the terminal:
.. code-block:: console
*** Booting Zephyr OS build v2.6.0-rc1 ***
Hello World! rcar_salvator_x
First of all, open your serial terminal.
Here is an example for the :zephyr:code-sample:hello_world application.
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: rcar_salvator_x :goals: debug
You will then get access to a GDB session for debug.
By continuing the app, you should see the following message in the terminal:
.. code-block:: console
*** Booting Zephyr OS build v2.6.0-rc1 ***
Hello World! rcar_salvator_x
References
Renesas R-Car H3 chip_Renesas R-Car Development Support website_eLinux H3 Salvator-X page_.. _Renesas R-Car H3 chip: 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
.. _Renesas R-Car Development Support website: https://www.renesas.com/us/en/support/partners/r-car-consortium/r-car-development-support
.. _eLinux H3 Salvator-X page: https://elinux.org/R-Car/Boards/Salvator-X
.. _Install a toolchain: https://docs.zephyrproject.org/latest/getting_started/index.html#install-a-toolchain