boards/renesas/rcar_spider_s4/doc/index.rst
.. zephyr:board:: rcar_spider_s4
Overview
R-Car S4 Spider board is based on the R-Car S4 SoC made for Car Server/Communication Gateway and that is composed of a octo Cortex®-A55, a dual lockstep Cortex®-R52 and a double dual lockstep G4MH.
The R-Car S4 SoC enables the launch of Car Server/CoGW with high performance, high-speed networking, high security and high functional safety levels that are required as E/E architectures evolve into domains and zones.
The R-Car S4 solution allows designers to re-use up to 88 percent of software code developed for 3rd generation R-Car SoCs and RH850 MCU applications. The software package supports the real-time cores with various drivers and basic software such as Linux BSP and hypervisors.
The Renesas R-Car Spider board is the Renesas R-Car S4 reference board and is designed for evaluating features and performance of this SoC.
Zephyr OS support is available for both Cortex®-A cores & Cortex®-R52 core.
More information about the S4 SoC can be found at Renesas R-Car S4 chip_.
Hardware
Spider features:
Connectors
CPU Board:
Breakout Board:
Input
Output
.. zephyr:board-supported-hw::
.. note::
It is recommended to disable peripherals used by the R52 core on the Linux host.
The Spider board consists of a CPU board plugged on top of a Breakout board.
Here are the official IOs figures from eLinux for S4 board:
S4 Spider CPU board IOs_
S4 Spider breakout board IOs_
By running Zephyr on S4 Spider, the software controllable LED 'LED8' can be used as output.
Here is information about both serial ports provided on the S4 Spider board :
+--------------------+----------+--------------------+-------------+------------------------+ | Physical Interface | Location | Software Interface | Converter | Further Information | +====================+==========+====================+=============+========================+ | CN20 USB Port | CPU Board| SCIF0/HSCIF1 | FT232HQ | Default Zephyr serial | +--------------------+----------+--------------------+-------------+------------------------+ | CN21 USB Port | CPU Board| SCIF3/HSCIF0 | FT2232H-56Q | Used by U-BOOT & Linux | +--------------------+----------+--------------------+-------------+------------------------+
.. note:: The Zephyr console output is assigned to SCIF0 (CN20 USB Port) with settings: 115200 8N1 without hardware flow control by default.
I2C is mainly used to manage and power-on some onboard chips on the S4 Spider board.
Embedded I2C devices and I/O expanders are not yet supported. The current I2C support therefore does not make any devices available to the user at this time.
Programming and Debugging (A55)
At that time, no direct flashing method is officially supported by this Zephyr port. However, it is possible to load the Zephyr binary using U-Boot commands.
One of the ways to load Zephyr is shown below.
.. code-block:: console
tftp 0x48000000 <tftp_server_path/zephyr.bin> booti 0x48000000
Here is an example for the :zephyr:code-sample:hello_world application.
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: rcar_spider_s4/r8a779f0/a55 :goals: build
Programming and Debugging (R52)
.. 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 with a "Coresight 20 pins" adapter to CN1 connector on Spider board.
Connect a USB cable from your PC to CN20 USB port of your Spider board.
Use the following settings with your serial terminal of choice (minicom, putty, etc.):
First of all, open your serial terminal.
Applications for the rcar_spider_s4/r8a779f0/r52 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_spider_s4/r8a779f0/r52 :goals: flash
You should see the following message in the terminal:
.. code-block:: console
*** Booting Zephyr OS build v3.3.0-rc2 ***
Hello World! rcar_spider_s4
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_spider_s4/r8a779f0/r52 :goals: debug
You will then get access to a GDB session for debugging.
By continuing the app, you should see the following message in the terminal:
.. code-block:: console
*** Booting Zephyr OS build v3.3.0-rc2 ***
Hello World! rcar_spider_s4
References
Renesas R-Car S4 Spider_Renesas R-Car S4 chip_eLinux S4 Spider_.. _Renesas R-Car S4 Spider: https://www.renesas.com/us/en/products/automotive-products/automotive-system-chips-socs/rtp8a779f0askb0sp2s-r-car-s4-reference-boardspider
.. _Renesas R-Car S4 chip: https://www.renesas.com/us/en/products/automotive-products/automotive-system-chips-socs/r-car-s4-automotive-system-chip-soc-car-servercommunication-gateway
.. _eLinux S4 Spider: https://elinux.org/R-Car/Boards/Spider
.. _S4 Spider CPU board IOs: https://elinux.org/images/6/6d/Rcar_s4_spider_cpu_board.jpg
.. _S4 Spider breakout board IOs: https://elinux.org/images/2/29/Rcar_s4_spider_breakout_board.jpg