Difference between revisions of "R-Car"

From eLinux.org
Jump to: navigation, search
m
(Add V4H White Hawk board)
 
(91 intermediate revisions by 20 users not shown)
Line 1: Line 1:
 +
{{TOC right}}
 +
 
'''<span style="color:#008000;">Jump to R-Car boards pages</span>''' <sub>[[File:Arrow Right-Down.svg|19px|frameless]]</sub>
 
'''<span style="color:#008000;">Jump to R-Car boards pages</span>''' <sub>[[File:Arrow Right-Down.svg|19px|frameless]]</sub>
  
 
+
* [[R-Car/Boards/Alt|Alt]]
  * [[R-Car/Boards/Alt|Alt]]
+
* [[R-Car/Boards/BOCK-W|BOCK-W]]
  * [[R-Car/Boards/Blanche|Blanche]]
+
* [[R-Car/Boards/Draak|Draak]]
  * [[R-Car/Boards/BOCK-W|BOCK-W]]
+
* [[R-Car/Boards/Ebisu|Ebisu]]
  * [[R-Car/Boards/Gose|Gose]]
+
* [[R-Car/Boards/Gose|Gose]]
  * [[R-Car/Boards/Koelsch|Koelsch]]
+
* [[R-Car/Boards/Koelsch|Koelsch]]
  * [[R-Car/Boards/Lager|Lager]]
+
* [[R-Car/Boards/Lager|Lager]]
  * [[R-Car/Boards/Marzen|Marzen]]
+
* [[R-Car/Boards/Marzen|Marzen]]
  * [[R-Car/Boards/Porter |Porter]]
+
* [[R-Car/Boards/Porter |Porter]]
  * [[R-Car/Boards/Wheat |Wheat]]
+
* [[R-Car/Boards/Salvator-X|Salvator-X]]
  * [[R-Car/Boards/Salvator-X|Salvator-X]]
+
* [[R-Car/Boards/Salvator-XS|Salvator-XS]]
  * [[R-Car/Boards/SILK|SILK]]
+
* [[R-Car/Boards/SILK|SILK]]
  * [[R-Car/Boards/Stout|ADAS Starter Kit (Stout)]]
+
* [[R-Car/Boards/M3SK |R-Car Starter Kit Pro]]
  * [[R-Car/Boards/Stout:View|ADAS Surround View Kit]]
+
* [[R-Car/Boards/H3SK |R-Car Starter Kit Premier]]
  * [[R-Car/Boards/M3SK |R-Car Starter Kit Pro]]
+
* [[R-Car/Boards/M3NSK |R-Car Starter Kit Pro(M3N)]]
  * [[R-Car/Boards/H3SK |R-Car Starter Kit Premier]]
+
* Gen2 ADAS boards:
  * [[R-Car/Boards/ADAS-View-Solution-Kit |R-Car ADAS View Solution Kit]]
+
** [[R-Car/Boards/Blanche|Blanche]]
 
+
** [[R-Car/Boards/Wheat|Wheat]]
 
+
** [[R-Car/Boards/Stout|ADAS Starter Kit (Stout)]]
{{TOC right}}
+
** [[R-Car/Boards/Stout:View|ADAS Surround View Kit]]
 +
* Gen3 ADAS boards ([[R-Car/Boards/Yocto-Gen3-ADAS|common instructions]]):
 +
** [[R-Car/Boards/Salvator-X-view|Salvator-X View Kit]]
 +
** [[R-Car/Boards/ADAS-View-Solution-Kit |ADAS View Solution Kit]]
 +
** [[R-Car/Boards/HAD-Solution-Kit |HAD Solution Kit]]
 +
** [[R-Car/Boards/Kingfisher|Kingfisher Infotainment Board]]
 +
** [[R-Car/Boards/Eagle|V3M Eagle Board]]
 +
** [[R-Car/Boards/V3MSK |R-Car V3M Starter Kit]]
 +
** [[R-Car/Boards/Condor|V3H Condor Board]]
 +
** [[R-Car/Boards/V3HSK |R-Car V3H Starter Kit]]
 +
* Gen3 Connected Boards:
 +
** [[R-Car/Boards/CCPF-SK |CCPF-SK]]
 +
* Gen4 ADAS boards
 +
** [[R-Car/Boards/Falcon|V3U Falcon Board]]
 +
** [[R-Car/Boards/WhiteHawk|V4H White Hawk Board]]
 +
* Gen4 Gateway Boards:
 +
** [[R-Car/Boards/Spider |Spider]]
 +
** [[R-Car/Boards/S4SK |R-Car S4 Starter Kit]]
  
 
= Introduction =  
 
= Introduction =  
Line 27: Line 46:
  
 
Links below could be used to get familiar with Renesas Automotive SoCs and R-Car Concortia:
 
Links below could be used to get familiar with Renesas Automotive SoCs and R-Car Concortia:
*[http://am.renesas.com/applications/automotive/index.jsp Renesas Automotive Products / Solutions]
+
*[https://www.renesas.com/us/en/solutions/automotive.html Renesas Automotive Products / Solutions]
*[http://am.renesas.com/applications/automotive/cis/cis_highend/index.jsp Renesas Car Information Terminal Applications]
+
*[https://www.renesas.com/us/en/solutions/automotive/car-information-system.html Renesas Car Information Terminal Applications]
*[http://r-car-consortium.renesas.com/jpn/index.html R-Car Consortium]
+
*[https://www.renesas.com/us/en/support/partners/r-car-consortium.html R-Car Consortium]
  
 
Detailed information regarding R-Car SoCs (including roadmap, technical and marketing documents, BSPs and middleware) can be obtained directly from Renesas representative.
 
Detailed information regarding R-Car SoCs (including roadmap, technical and marketing documents, BSPs and middleware) can be obtained directly from Renesas representative.
Line 41: Line 60:
 
| '''Generation 2'''
 
| '''Generation 2'''
 
| '''Generation 3'''
 
| '''Generation 3'''
 +
| '''Generation 4'''
 
|-
 
|-
|'''"H"''' - Premium/High end
+
|'''"H"''' - High End
 
| '''H1''' - R8A7779
 
| '''H1''' - R8A7779
 
| '''H2''' - R8A7790
 
| '''H2''' - R8A7790
| '''H3''' - R8A7795 (or R8J7795)
+
| '''H3''' ES1.x - R8A77950 (or R8J77950)<br/>'''H3''' ES2.0+ - R8A77951 (or R8J77951)<br/>'''H3e(-2G)''' - R8A779M0/1<br/>'''H3Ne(-1.7G)''' - R8A779M8/B
 +
|
 
|-
 
|-
|'''"M"''' - Mid range
+
|'''"M"''' - Mid Range
 
| '''M1A''' - R8A7778
 
| '''M1A''' - R8A7778
|  
+
| '''M2-W''' - R8A7791<br/>'''M2-N''' - R8A7793
*'''M2-W''' - R8A7791
+
| '''M3-W''' - R8A77960<br/>'''M3-W+''' - R8A77961<br/>'''M3-N''' - R8A77965<br/>'''M3e(-2G)''' - R8A779M2/3<br/>'''M3Ne(-2G)''' - R8A779M4/5
*'''M2-N''' - R8A7793
+
|
| '''M3-W''' - R8A7796
 
 
|-
 
|-
|'''"E"''' - Entry class
+
|'''"E"''' - Entry
 
| '''E1'''
 
| '''E1'''
 
| '''E2''' - R8A7794
 
| '''E2''' - R8A7794
 +
| '''E3''' - R8A77990<br/>'''E3e''' - R8A779M6
 
|
 
|
 
|-
 
|-
|'''"V"''' - ADAS
+
|'''"D"''' - Dashboard
 
|
 
|
|'''V2H''' - R8A7792
 
 
|
 
|
 +
| '''D3''' - R8A77995<br/>'''D3e''' - R8A779M7
 +
|
 +
|-
 +
|'''"S"''' - Gateway
 +
|
 +
|
 +
|
 +
| '''S4-8''' ES1.0 - R8A779F0<br/>'''S4-8''' ES1.1+ - R8A779F4
 +
|-
 +
|'''"V"''' - Vision
 +
|
 +
| '''V2H''' - R8A7792
 +
| '''V3M''' - R8A77970<br/>'''V3H''' - R8A77980<br/>'''V3H2''' - R8A77980A
 +
| '''V3U''' - R8A779A0<br/>'''V4H''' - R8A779G0
 
|}
 
|}
  
Line 133: Line 167:
 
|'''Low Cost Boards (LCB)'''
 
|'''Low Cost Boards (LCB)'''
 
|-
 
|-
|'''R-Car H3'''  
+
|'''R-Car H3/H3e'''  
|[[R-Car/Boards/Salvator-X|Salvator-X]]
+
|[[R-Car/Boards/Salvator-X|Salvator-X]]<br/>[[R-Car/Boards/Salvator-XS|Salvator-XS]]
 
|[[R-Car/Boards/H3SK| R-Car Starter Kit Premier]]
 
|[[R-Car/Boards/H3SK| R-Car Starter Kit Premier]]
 
|-
 
|-
|'''R-Car M3-W'''  
+
|'''R-Car M3-W/M3e'''  
|[[R-Car/Boards/Salvator-X|Salvator-X]]
+
|[[R-Car/Boards/Salvator-X|Salvator-X]]<br/>[[R-Car/Boards/Salvator-XS|Salvator-XS]]
 
|[[R-Car/Boards/M3SK|R-Car Starter Kit Pro]]
 
|[[R-Car/Boards/M3SK|R-Car Starter Kit Pro]]
 +
|-
 +
|'''R-Car M3-N/M3Ne'''
 +
|[[R-Car/Boards/Salvator-X|Salvator-X]]<br/>[[R-Car/Boards/Salvator-XS|Salvator-XS]]
 +
|[[R-Car/Boards/M3NSK|R-Car Starter Kit Pro(M3N)]]
 +
|-
 +
|'''R-Car E3'''
 +
|[[R-Car/Boards/Ebisu|Ebisu]]
 +
|
 +
|-
 +
|'''R-Car D3'''
 +
|[[R-Car/Boards/Draak|Draak]]
 +
|
 +
|-
 +
|'''R-Car V3M'''
 +
|[[R-Car/Boards/Eagle|Eagle]]
 +
|[[R-Car/Boards/V3MSK|Starter Kit]]
 +
|-
 +
|'''R-Car V3H'''
 +
|[[R-Car/Boards/Condor|Condor]]
 +
|[[R-Car/Boards/V3HSK|Starter Kit]]
 +
|-
 +
|'''R-Car V3H2'''
 +
|Condor-I
 +
|
 +
|-
 +
|}
 +
 +
== Generation 4 ==
 +
 +
{| class="wikitable"
 +
|+ Renesas R-Car Gen4 evaluation boards
 +
|-
 +
|
 +
|'''Standard'''
 +
|'''Low Cost Boards (LCB)'''
 +
|-
 +
|'''R-Car S4'''
 +
|[[R-Car/Boards/Spider|Spider]]
 +
|[[R-Car/Boards/S4SK|R-Car S4 Starter Kit]]
 +
|-
 +
|'''R-Car V3U'''
 +
|[[R-Car/Boards/Falcon|Falcon]]
 +
|
 +
|-
 +
|'''R-Car V4H'''
 +
|[[R-Car/Boards/WhiteHawk|White Hawk]]
 +
|
 
|-
 
|-
 
|}
 
|}
Line 147: Line 228:
 
== Upstream ==
 
== Upstream ==
  
Renesas mainline R-Car Linux tree is maintained by [http://horms.org/about_me.shtml Simon Horman]
+
Renesas mainline R-Car Linux tree is maintained by Geert Uytterhoeven
  
 
Start here to get latest/closest upstream kernel:
 
Start here to get latest/closest upstream kernel:
git://git.kernel.org/pub/scm/linux/kernel/git/horms/renesas.git
+
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/horms/renesas.git
+
  e.g. pull development branch: git clone -b devel git://git.kernel.org/pub/scm/linux/kernel/git/geert/renesas-devel.git
  
 
=== Branches ===
 
=== 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'''
 
* '''next'''
** Patches queued up for the forthcoming Kernel release
+
** Patches queued up for the forthcoming kernel release
** This is included in net-next and complies with its rules
+
** 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 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.
 
** 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.
* '''devel'''
 
** All patches queued up for submission to the ARM-SoC maintainers
 
** This is a feeder for the next branch and allows patches to be queued up during times when updates to the next branch are not appropriate
 
** Based on a merge of the next branch and the latest rc or full release
 
 
* '''*-for-vX.Y'''
 
* '''*-for-vX.Y'''
 
** Individual patch-queues for the ARM-SoC maintainers as per their requirements for patches to be broken out into branches
 
** 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
 
** Patches are targeted at kernel version X.Y
** Merged into next or devel
+
** Merged into next
 +
* '''topic/renesas-defconfig'''
 +
** Sample defconfig file for Renesas R-Car Gen3 and RZ/G2 boards
 +
** Not intended for upstream merge
 
* '''topic/*'''
 
* '''topic/*'''
 
** Branches for specific new features
 
** Branches for specific new features
Line 176: Line 261:
 
=== Hardware Support Status (Incomplete) ===
 
=== Hardware Support Status (Incomplete) ===
 
* [[Renesas-MMC-Enabled-Speeds|Enabled Speeds for MMC Devices on R-Car Gen 2 and 3]]
 
* [[Renesas-MMC-Enabled-Speeds|Enabled Speeds for MMC Devices on R-Car Gen 2 and 3]]
 +
 +
=== Tips ===
 +
* [[R-Car/Merging-MMC-block-requests|Merging MMC block requests by using IOMMU]]
 +
* [[R-Car/Use-MMC-block-as-rootfs-on-v5-10|How to use MMC block device as rootfs on v5.10-rc1?]]
 +
* [[R-Car/Use-GPIO-for-SD-card-detection|Use GPIO for SD card detection]]
 +
* [[R-Car/Change-probing-timing-of-USB-2-function-driver|Change probing timing of USB 2.0 function driver on Salvator-XS from v5.13-rc1]]
 +
* [[R-Car/Default-CPUFreq-governor-from-v5-9|Default CPUFreq governor from v5.9]]
 +
* [[R-Car/xhci-rcar-driver-waits-for-firmware-loading|xhci-rcar driver waits for firmware loading in kernel booting when using defconfig]]
 +
* [[R-Car/Debugging-kernel-options-causes-performance-down|Debugging kernel options causes performance down]]
 +
* [[R-Car/How-to-describe-device-tree-for-R-Car-Gen3-USB2-DRD-channel|How to describe device tree for R-Car Gen3 USB2.0 DRD channel]]
  
 
== R-Car Community==
 
== R-Car Community==
 
*Mailing list - via kernel.org [mailto:majordomo@vger.kernel.org?body=subscribe linux-renesas-soc Majordomo].
 
*Mailing list - via kernel.org [mailto:majordomo@vger.kernel.org?body=subscribe linux-renesas-soc Majordomo].
Archives available here: http://dir.gmane.org/gmane.linux.kernel.renesas-soc , http://www.spinics.net/lists/linux-renesas-soc/
+
Archives available here: https://lore.kernel.org/linux-renesas-soc/ , http://www.spinics.net/lists/linux-renesas-soc/
  
 
== LTSI (Long Term Support Initiative) ==
 
== LTSI (Long Term Support Initiative) ==
  
Renesas SoCs and boards are supported as part of LTSI project - http://ltsi.linuxfoundation.org/ . Refer to [http://ltsi.linuxfoundation.org/releases/ltsi-tree/4.1.17-ltsi/stable-release 4.1.17-LTSI] and [http://ltsi.linuxfoundation.org/releases/ltsi-tree/3.14.28-ltsi/stable-release 3.14.28-LTSI].
+
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/ https://ltsi.linuxfoundation.org/software/releases].
  
 
== Renesas R-Car Gen 2 BSP Tree ==
 
== Renesas R-Car Gen 2 BSP Tree ==
Line 193: Line 288:
 
== Renesas R-Car Gen 3 BSP Tree ==
 
== Renesas R-Car Gen 3 BSP Tree ==
  
Renesas R-Car Gen 2 BSP Tree located at: git://git.kernel.org/pub/scm/linux/kernel/git/horms/renesas-bsp.git.
+
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.
 
Check out the latest R-Car Gen 3 BSP release tag.
  
  for example: rcar-3.2.1
+
  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 =
 
= R-Car U-Boot =
  
R-Car U-Boot mainline development is done using git://git.denx.de/u-boot-sh.git tree. It is maintained by Nobuhiro Iwamatsu.
+
For Gen3 see [[R-Car/Boards/U-Boot-Gen3|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
 
  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://git.denx.de/u-boot-sh.git
+
  git clone -b renesas/bsp/rcar-gen2-1.8.0  git@gitlab.denx.de:u-boot/custodians/u-boot-sh.git
  
 
build example
 
build example
Line 213: Line 312:
 
= R-Car Yocto =
 
= R-Car Yocto =
  
Renesas Yocto/Poky distribution is maintained by Nobuhiro Iwamatsu.  
+
*For Gen3, see [[R-Car/Boards/Yocto-Gen3|Yocto-Gen3]]
 +
*Community BSP following official Yocto Project versions
 +
<ol>Refer to README.md for release policy and build instructions.<br>
 +
To integrate evaluation version of proprietary graphics and multimedia drivers from Renesas, refer to README.evaproprietary.md.<br>
 +
Repository location: https://github.com/renesas-rcar/meta-renesas.git<br>
 +
{| class="wikitable"
 +
|+ 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
 +
|[https://github.com/renesas-rcar/meta-renesas/blob/sumo-dev/meta-rcar-gen3/README.md README.md] and [https://github.com/renesas-rcar/meta-renesas/blob/sumo-dev/meta-rcar-gen3/README.evaproprietary.md README.evaproprietary.md]
 +
|-
 +
|'''YP 2.6 (codename: thud)'''
 +
|thud-dev
 +
|thud-Yocto-v3.21.0
 +
|[https://github.com/renesas-rcar/meta-renesas/blob/thud-dev/meta-rcar-gen3/README.md README.md] and [https://github.com/renesas-rcar/meta-renesas/blob/thud-dev/meta-rcar-gen3/README.evaproprietary.md README.evaproprietary.md]
 +
|-
 +
|'''YP 2.7 (codename: warrior)'''
 +
|warrior-dev
 +
|warrior-Yocto-v3.19.0
 +
|[https://github.com/renesas-rcar/meta-renesas/blob/warrior-dev/meta-rcar-gen3/README.md README.md] and [https://github.com/renesas-rcar/meta-renesas/blob/warrior-dev/meta-rcar-gen3/README.evaproprietary.md README.evaproprietary.md]
 +
|-
 +
|'''YP 3.0 (codename: zeus)'''
 +
|zeus-dev
 +
|zeus-Yocto-v3.21.0
 +
|[https://github.com/renesas-rcar/meta-renesas/blob/zeus-dev/meta-rcar-gen3/README.md README.md] and [https://github.com/renesas-rcar/meta-renesas/blob/zeus-dev/meta-rcar-gen3/README.evaproprietary.md README.evaproprietary.md]
 +
|-
 +
|}
 +
</ol>
  
To get started with Yocto on R-Car Gen2 platform - pull git://git.yoctoproject.org/meta-renesas tree
+
*Renesas Yocto/Poky distribution
 +
<ol>Renesas Yocto/Poky distribution is maintained by Takamitsu Honda.<br>
 +
To get started with Yocto on R-Car Gen2 platform - pull git://git.yoctoproject.org/meta-renesas tree<br>
 +
If you pulled complete Yocto/poky trees, you should be able to kick-off a build using the 'oe-init-build-env' script in Poky. <br>
  
If you pulled complete Yocto/poky trees, you should be able to kick-off a build using the 'oe-init-build-env' script in Poky.
 
 
Update bblayers.conf by adding the meta-renesas and meta-rcar-gen2 layer. e.g.:
 
Update bblayers.conf by adding the meta-renesas and meta-rcar-gen2 layer. e.g.:
 
+
<pre>
 
         BBLAYERS ?= " \
 
         BBLAYERS ?= " \
 
                 <path to layer>/poky/meta \
 
                 <path to layer>/poky/meta \
Line 227: Line 362:
 
                 <path to layer>/meta-renesas/meta-rcar-gen2 \
 
                 <path to layer>/meta-renesas/meta-rcar-gen2 \
 
         "
 
         "
 +
</pre>
  
 
To build a specific target BSP configure the associated machine in local.conf:
 
To build a specific target BSP configure the associated machine in local.conf:
 
+
<pre>
 
         MACHINE ?= "<supported board name>" (lager, koelsch, gose, alt)
 
         MACHINE ?= "<supported board name>" (lager, koelsch, gose, alt)
 
+
</pre>
 
Build the target file system image using bitbake:
 
Build the target file system image using bitbake:
 
+
<pre>
 
         $ bitbake core-image-minimal
 
         $ bitbake core-image-minimal
 +
</pre>
 +
</ol>
  
 
= R-Car Automotive Grade Linux =
 
= R-Car Automotive Grade Linux =
  
Automotive Grade Linux (AGL) is a Linux Foundation Workgroup dedicated to creating open source software solutions for automotive applications.
+
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 and R-Car Porter board can be used to start an AGL distribution. Please check [[/Boards/Porter#Which_operating_systems.2Fdistributions_can_be_used_with_R-Car_M2_Porter_board.3F|this page]].
+
AGL is based on Yocto project for its construction.
 +
: To start an AGL distribution on R-Car Porter board, please check [[/Boards/Porter#Which_operating_systems.2Fdistributions_can_be_used_with_R-Car_M2_Porter_board.3F|this page]].
 +
: To start an AGL distribution on R-Car Starter Kit(s), please check [[ R-Car/AGL | this page ]] and AGL documentation [https://docs.automotivelinux.org/en/master/#0_Getting_Started/2_Building_AGL_Image/5_3_RCar_Gen_3/ here].
  
 
= R-Car Genivi =
 
= R-Car Genivi =
 
''GENIVI® is a nonprofit industry alliance committed to driving the broad adoption of specified, open source, In-Vehicle Infotainment (IVI) software''.
 
''GENIVI® is a nonprofit industry alliance committed to driving the broad adoption of specified, open source, In-Vehicle Infotainment (IVI) software''.
Source: http://www.genivi.org/
+
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 [https://at.projects.genivi.org/wiki/display/PROJ/GENIVI+Baselines Genivi Yocto Baseline] and [https://at.projects.genivi.org/wiki/pages/viewpage.action?pageId=11567210 Genivi Development Platform (GDP)] already integrated. It is supported on a best effort basis.
 
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 [https://at.projects.genivi.org/wiki/display/PROJ/GENIVI+Baselines Genivi Yocto Baseline] and [https://at.projects.genivi.org/wiki/pages/viewpage.action?pageId=11567210 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 [https://at.projects.genivi.org/wiki/display/PROJ/Meta+ivi+BSPs+for+Specific+Hardware here].
+
You can find more information about building the Genivi Yocto Baseline for various Genivi versions in the Alliance pages for meta-ivi [https://at.projects.genivi.org/wiki/display/PROJ/Meta+ivi+BSPs+for+Specific+Hardware here]. Information on building GDP Master for the Renesas R-Car SoCs can be found [https://at.projects.genivi.org/wiki/display/GDP/GDP+Master here].
Information on building GDP for R-Car M2 Porter can be found [https://at.projects.genivi.org/wiki/display/GDP/Renesas+R-Car+M2+Porter+Hardware+Setup+and+Software+Installation here] and E2 Silk [https://at.projects.genivi.org/wiki/display/GDP/Renesas+R-Car+E2+Silk+Hardware+Set+Up+And+Software+Installation here].
+
 
 +
= R-Car Virtualization =
 +
 
 +
See [[R-Car/Virtualization]].
  
 
= R-Car Tizen =
 
= 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''
+
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 =
 
= R-Car Android =
  
TBD ''This section will be added later''
+
See [[R-Car/Boards/Kingfisher/Android]].
 +
 
 +
= R-Car Zephyr =
 +
 
 +
* For Gen3 Cortex R7 support, see :
 +
 
 +
{| class="wikitable"
 +
|-
 +
! Supported board
 +
! Zephyr Version
 +
! BSP Release date
 +
|-
 +
| rowspan="2" | H3ULCB
 +
| [[R-Car/Boards/Zephyr-Gen3/2.7|2.7 LTS]] <span style="color:#ff0000;">[New!!]</span>
 +
| 2021/10/22
 +
|-
 +
| [[R-Car/Boards/Zephyr-Gen3/2.6|2.6]]
 +
| 2021/06/11
 +
|}
 +
 
 +
* Since v2.6, Renesas R-Car H3ULCB is supported by the Zephyr project.
 +
* Although the plan is to have the best support for R-Car Gen3 in Zephyr mainline. Using a downstream repository is still required for using drivers that have not been submitted yet to Zephyr upstream.
 +
 
 +
= 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]]<br>
 +
日本語ver. [[R-Car/Ubuntu(J)]]<br>
 +
 
 +
[[Category:Automotive]]
 +
[[Category:R-Car]]
 +
 
 +
= R-Car Chromium =
 +
See [[R-Car/Chromium]].
 +
 
 +
= Kubernetes(k8s) on R-Car =
 +
See [[R-Car/k8s(J)]].
 +
 
 +
= LAVA testing with R-Car =
 +
See [[R-Car/LAVA]].
 +
 
 +
= AWS IoT Greengrass =
 +
See [[R-Car/AWS IoT Greengrass]].

Latest revision as of 06:57, 17 October 2023

Jump to R-Car boards pages Arrow Right-Down.svg

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 Generation 4
"H" - High End H1 - R8A7779 H2 - R8A7790 H3 ES1.x - R8A77950 (or R8J77950)
H3 ES2.0+ - R8A77951 (or R8J77951)
H3e(-2G) - R8A779M0/1
H3Ne(-1.7G) - R8A779M8/B
"M" - Mid Range M1A - R8A7778 M2-W - R8A7791
M2-N - R8A7793
M3-W - R8A77960
M3-W+ - R8A77961
M3-N - R8A77965
M3e(-2G) - R8A779M2/3
M3Ne(-2G) - R8A779M4/5
"E" - Entry E1 E2 - R8A7794 E3 - R8A77990
E3e - R8A779M6
"D" - Dashboard D3 - R8A77995
D3e - R8A779M7
"S" - Gateway S4-8 ES1.0 - R8A779F0
S4-8 ES1.1+ - R8A779F4
"V" - Vision V2H - R8A7792 V3M - R8A77970
V3H - R8A77980
V3H2 - R8A77980A
V3U - R8A779A0
V4H - R8A779G0

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 65px-Stout top.png
ADAS Starter Kit (Stout)
ADAS Surround View Kit
R-Car M2-W Koelsch 65px-Porter top.png
Porter
R-Car M2-N Gose
R-Car E2 Alt 65px-Silk top.png
SILK
R-Car V2H Blanche 65px-Wheat top.png
Wheat

Generation 3

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

Generation 4

Renesas R-Car Gen4 evaluation boards
Standard Low Cost Boards (LCB)
R-Car S4 Spider R-Car S4 Starter Kit
R-Car V3U Falcon
R-Car V4H White Hawk

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)

Tips

R-Car Community

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
    Refer to README.md for release policy and build instructions.
    To integrate evaluation version of proprietary graphics and multimedia drivers from Renesas, refer to README.evaproprietary.md.
    Repository location: 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
    Renesas Yocto/Poky distribution is maintained by Takamitsu Honda.
    To get started with Yocto on R-Car Gen2 platform - pull git://git.yoctoproject.org/meta-renesas tree
    If you pulled complete Yocto/poky trees, you should be able to kick-off a build using the 'oe-init-build-env' script in Poky.
    Update bblayers.conf by adding the meta-renesas and meta-rcar-gen2 layer. e.g.:
            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 this page and 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 Zephyr

  • For Gen3 Cortex R7 support, see :
Supported board Zephyr Version BSP Release date
H3ULCB 2.7 LTS [New!!] 2021/10/22
2.6 2021/06/11
  • Since v2.6, Renesas R-Car H3ULCB is supported by the Zephyr project.
  • Although the plan is to have the best support for R-Car Gen3 in Zephyr mainline. Using a downstream repository is still required for using drivers that have not been submitted yet to Zephyr upstream.

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).

LAVA testing with R-Car

See R-Car/LAVA.

AWS IoT Greengrass

See R-Car/AWS IoT Greengrass.