Jump to R-Car boards pages

Introduction

This is starting page for Embedded Linux on Renesas R-Car family of automotive embedded SoCs. Main goal is to make information on R-Car SoCs friendly, easy to access for embedded developers, enthusiasts. It does not aim to replace official Renesas support.

Links below could be used to get familiar with Renesas Automotive SoCs and R-Car Concortia:

Detailed information regarding R-Car SoCs (including roadmap, technical and marketing documents, BSPs and middleware) can be obtained directly from Renesas representative.

R-Car SoCs

Renesas R-Car SoC variants (Generations)
	Generation 1	Generation 2	Generation 3
"H" - High End	H1 - R8A7779	H2 - R8A7790	H3 ES1.x - R8A77950 (or R8J77950) H3 ES2.0+ - R8A77951 (or R8J77951)
"M" - Mid Range	M1A - R8A7778	M2-W - R8A7791 M2-N - R8A7793	M3-W - R8A77960 M3-W+ - R8A77961 M3-N - R8A77965
"E" - Entry	E1	E2 - R8A7794	E3 - R8A77990
"D" - Dashboard			D3 - R8A77995
"V" - Vision		V2H - R8A7792	V3M - R8A77970 V3H - R8A77980

The R-Car devices pages lists the peripheral devices available in the R-Car SoCs along with usage information and test procedures.

R-Car Boards

Generation 1

Renesas R-Car Gen1 evaluation boards
	Standard	Low Cost Boards (LCB)
R-Car H1	Marzen	Geuze
R-Car M1A	BOCK-W	Milan
R-Car E1	Silverstone

Generation 2

Renesas R-Car Gen2 evaluation boards
	Standard	Low Cost Boards (LCB)
R-Car H2	Lager	ADAS Starter Kit (Stout) ADAS Surround View Kit
R-Car M2-W	Koelsch	Porter
R-Car M2-N	Gose
R-Car E2	Alt	SILK
R-Car V2H	Blanche	Wheat

Generation 3

Renesas R-Car Gen3 evaluation boards
	Standard	Low Cost Boards (LCB)
R-Car H3	Salvator-X Salvator-XS	R-Car Starter Kit Premier
R-Car M3-W	Salvator-X Salvator-XS	R-Car Starter Kit Pro
R-Car M3-N	Salvator-X Salvator-XS	R-Car Starter Kit Pro(M3N)
R-Car E3	Ebisu
R-Car V3M	Eagle	Starter Kit
R-Car V3H	Condor	Starter Kit
R-Car D3	Draak

R-Car Linux

Upstream

Renesas mainline R-Car Linux tree is maintained by Geert Uytterhoeven

Start here to get latest/closest upstream kernel: git://git.kernel.org/pub/scm/linux/kernel/git/geert/renesas-devel.git

e.g. pull development branch: git clone -b devel git://git.kernel.org/pub/scm/linux/kernel/git/geert/renesas-devel.git

Branches

master
- Current development version
- Based on latest upstream point or rc release
- Includes patches queued up for the forthcoming kernel release (or later)
- Includes 'topic/renesas-defconfig'
next
- Patches queued up for the forthcoming kernel release
- This is included in linux-next and complies with its rules
- It is a feeder for submissions (pull requests) to the ARM-SoC maintainers
- It is generally based on the latest rc1 release but may be based on a later rc release in order to provide a working kernel for ARM (32-bit) and ARM64 based Renesas SoCs.
*-for-vX.Y
- Individual patch-queues for the ARM-SoC maintainers as per their requirements for patches to be broken out into branches
- Patches are targeted at kernel version X.Y
- Merged into next
topic/renesas-defconfig
- Sample defconfig file for Renesas R-Car Gen3 and RZ/G2 boards
- Not intended for upstream merge
topic/*
- Branches for specific new features
- Pushed when the features are under review of otherwise not queued up for submission to the ARM-SoC maintainers
other
- Temporary branches typically for testing purposes

Hardware Support Status (Incomplete)

Enabled Speeds for MMC Devices on R-Car Gen 2 and 3

Tips

R-Car Community

Mailing list - via kernel.org linux-renesas-soc Majordomo.

Archives available here: https://lore.kernel.org/linux-renesas-soc/ , http://www.spinics.net/lists/linux-renesas-soc/

LTSI (Long Term Support Initiative)

Renesas SoCs and boards are supported as part of LTSI project - https://ltsi.linuxfoundation.org/ .For all LTSI kernel releases, refer to https://ltsi.linuxfoundation.org/software/releases.

Renesas R-Car Gen 2 BSP Tree

Renesas R-Car Gen 2 BSP Tree located at: git://git.kernel.org/pub/scm/linux/kernel/git/horms/renesas-backport.git. Check out the latest R-Car Gen 2 BSP release tag.

for example: rcar-gen2/v1.9.7

Renesas R-Car Gen 3 BSP Tree

Renesas R-Car Gen 3 BSP Tree located at: https://github.com/renesas-rcar/linux-bsp.git. Check out the latest R-Car Gen 3 BSP release tag.

for example: rcar-3.9.2

NOTE: The git repo at git://git.kernel.org/pub/scm/linux/kernel/git/horms/renesas-bsp.git become outdated from Oct 2019.

R-Car U-Boot

For Gen3 see U-Boot-Gen3.

R-Car U-Boot mainline development is done using git@gitlab.denx.de:u-boot/custodians/u-boot-sh.git tree. It is maintained by Nobuhiro Iwamatsu.

e.g. pull renesas/bsp/rcar-gen2-1.8.0 branch and build U-Boot for Lager/Koelsch/Alt boards
git clone -b renesas/bsp/rcar-gen2-1.8.0  git@gitlab.denx.de:u-boot/custodians/u-boot-sh.git

build example

make O=/tmp/build clean
make O=/tmp/build mrproper
make O=/tmp/build gose_config
make O=/tmp/build all

R-Car Yocto

For Gen3, see Yocto-Gen3
Community BSP following official Yocto Project versions

https://github.com/renesas-rcar/meta-renesas.git

Latest R-Car Gen3 Community BSP
Yocto Project (YP) releases	Branch name	Tag name	For build instructions, refer to
YP 2.5 (codename: sumo)	sumo-dev	sumo-Yocto-v3.15.0	README.md and README.evaproprietary.md
YP 2.6 (codename: thud)	thud-dev	thud-Yocto-v3.21.0	README.md and README.evaproprietary.md
YP 2.7 (codename: warrior)	warrior-dev	warrior-Yocto-v3.19.0	README.md and README.evaproprietary.md
YP 3.0 (codename: zeus)	zeus-dev	zeus-Yocto-v3.21.0	README.md and README.evaproprietary.md

Renesas Yocto/Poky distribution

git://git.yoctoproject.org/meta-renesas

        BBLAYERS ?= " \
                <path to layer>/poky/meta \
                <path to layer>/poky/meta-yocto \
                <path to layer>/poky/meta-yocto-bsp \
                <path to layer>/meta-renesas \
                <path to layer>/meta-renesas/meta-rcar-gen2 \
        "

To build a specific target BSP configure the associated machine in local.conf:

        MACHINE ?= "<supported board name>" (lager, koelsch, gose, alt)

Build the target file system image using bitbake:

        $ bitbake core-image-minimal

R-Car Automotive Grade Linux

Automotive Grade Linux(TM) (AGL: https://www.automotivelinux.org/ ) is a Linux Foundation Workgroup dedicated to creating open source software solutions for automotive applications. AGL is based on Yocto project for its construction.

To start an AGL distribution on R-Car Porter board, please check this page.

To start an AGL distribution on R-Car Starter Kit(s), please check AGL documentation here.

R-Car Genivi

GENIVI® is a nonprofit industry alliance committed to driving the broad adoption of specified, open source, In-Vehicle Infotainment (IVI) software. Source: https://www.genivi.org/

As a service to the community Renesas maintains a git repository containing a R-Car Yocto BSP with the changes required for the standard Yocto BSP to work with the Genivi Yocto Baseline and Genivi Development Platform (GDP) already integrated. It is supported on a best effort basis.

You can find more information about building the Genivi Yocto Baseline for various Genivi versions in the Alliance pages for meta-ivi here. Information on building GDP Master for the Renesas R-Car SoCs can be found here.

R-Car Virtualization

See R-Car/Virtualization.

R-Car Tizen

TBD Renesas R-Car Tizen is already available via tizen.org trees. Add detailed instructions how to get started with Tizen for R-Car

R-Car Android

See R-Car/Boards/Kingfisher/Android.

R-Car Emotion Recognition Engine SDK

See R-Car/Emotion Recognition Engine SDK Image preparation guide

R-Car Connected Car SDK

See R-Car/Connected Car SDK startup guide

Ubuntu on R-Car

English ver. R-Car/Ubuntu
日本語ver. R-Car/Ubuntu(J)

R-Car Chromium

See R-Car/Chromium.

Kubernetes(k8s) on R-Car

See R-Car/k8s(J).

R-Car

Contents