Difference between revisions of "RZ-G"

From eLinux.org
Jump to: navigation, search
m (RZ/G Yocto Linux)
(added debug section)
(34 intermediate revisions by 2 users not shown)
Line 1: Line 1:
'''<span style="color:#008000;">Jump to RZ/G boards pages</span>''' <sub>[[File:Arrow Right-Down.svg|19px|frameless]]</sub>
+
{{TOC right|width=50%}}
 
+
= 💡 Introduction =  
[[File:65px-G1M_top.png|65px|link=RZ-G/Boards/SK-RZG1M]]<br/>[[RZ-G/Boards/SK-RZG1M |RZ/G1M Starter Kit]]
 
 
 
[[File:65px-G1E_top.png|65px|link=RZ-G/Boards/SK-RZG1E]]<br/>[[RZ-G/Boards/SK-RZG1E | RZ/G1E Starter Kit]]
 
 
 
{{TOC right}}
 
 
 
= Introduction =  
 
  
 
This is the starting page for Embedded Linux on the Renesas RZ/G family of embedded SoCs. The main goal is to make the information about RZ/G SoCs friendly, easy to access for embedded developers and enthusiasts. It does not aim to replace official Renesas support.
 
This is the starting page for Embedded Linux on the Renesas RZ/G family of embedded SoCs. The main goal is to make the information about RZ/G SoCs friendly, easy to access for embedded developers and enthusiasts. It does not aim to replace official Renesas support.
  
 
The links below can be used to get familiar with Renesas RZ/G SoC
 
The links below can be used to get familiar with Renesas RZ/G SoC
*[http://www.renesas.com/products/mpumcu/rz/rzg/index.jsp Renesas RZ/G overview]
+
*[https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz/rz-introductory-guide.html Introductory Guide to the RZ MPU Family]
  
 
Detailed information regarding RZ/G SoCs (including roadmap, technical and marketing documents, BSPs and middleware) can be obtained directly from a Renesas representative.
 
Detailed information regarding RZ/G SoCs (including roadmap, technical and marketing documents, BSPs and middleware) can be obtained directly from a Renesas representative.
  
= RZ/G SoCs =
+
<br>
{| class="wikitable"
+
 
|+ Renesas RZ/G SoC variants
+
= [[File:Board2.jpg|link=|caption]] RZ/G2 Boards =
|-
+
Here is the list of available [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-cortex-a-mpus/rzg-linux-platform/rzg-marketplace/board-solutions Renesas Evaluation Boards (link)] and commercial SOM boards.
|
+
 
| '''Generation 1'''
+
{| class="wikitable" style="border: none; background: none;"
|-
+
|+ Renesas RZ/G2 Boards
|'''"M"''' - Mid range
+
|- style="vertical-align: top;"
| '''1M''' - R8A7743
+
|'''RZ/G2E'''<br>R8A774C
|-
+
| '''Silicon Linux EK874''' <br> 📄  [https://si-linux.co.jp/index.php?CAT%2FCAT874 Product page (Silicon Linux)] <br> 📄 [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-cortex-a-mpus/rzg-linux-platform/rzg-marketplace/board-solutions/rzgb000011 Product page (Renesas)] <br> 🛠️ [[RZ-G/Boards/EK874 | EK874 Board Info and FAQ ]]
|'''"E"''' - Entry class
+
|- style="vertical-align: top;"
| '''1E''' - R8A7745
+
|'''RZ/G2M'''<br>R8A774A
 +
| '''RZ/G2M HiHope''' <br> 📄 [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-cortex-a-mpus/rzg-linux-platform/rzg-marketplace/board-solutions/rzgb000012 Product page] <br> 🛠️ [[RZ-G/Boards/HiHope | HiHope Board Info and FAQ]] <br> [https://www.amazon.com/dp/B08RNQ1R4V 🛒 Amazon Link]
 +
|- style="vertical-align: top;"
 +
|'''RZ/G2N'''<br>R8A774B
 +
| '''RZ/G2N HiHope''' <br> 📄 [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-cortex-a-mpus/rzg-linux-platform/rzg-marketplace/board-solutions/rzg2n-reference-board Product page] <br> 🛠️ [[RZ-G/Boards/HiHope | HiHope Board Info and FAQ]] <br> [https://www.amazon.com/dp/B08RNLBRK1?th=1 🛒 Amazon Link]
 +
|- style="vertical-align: top;"
 +
|'''RZ/G2H'''<br>R8A774E
 +
| '''RZ/G2H HiHope''' <br> 📄 [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-cortex-a-mpus/rzg-linux-platform/rzg-marketplace/board-solutions/rzg2h-reference-board Product page] <br> 🛠️ [[RZ-G/Boards/HiHope | HiHope Board Info and FAQ]]
 
|}
 
|}
  
= RZ/G Boards =
+
= 💡 RZ/G2 FAQ Section =
 
+
== Online Documents ==
== Generation 1 ==
+
* 📜 '''[https://www.renesas.com/us/en/products/rzg-linux-platform/rzg-marcketplace/document.html#manual Hardware Manuals]'''
 +
* 📜 '''[https://www.renesas.com/us/en/products/rzg-linux-platform/rzg-marcketplace/document.html Official Renesas Online Documentation (link)]'''
 +
:: 📄 (example documents on that page)
 +
:: 📄 '''RZ/G2 Group Linux BSP Porting Guide''' - How to modify the Renesas BSP to match your board
 +
:: 📄 '''RZ/G2 Group BSP Manual Set''' - Information about BSP device drivers and Device Tree configurations. It also contains information regarding GStreamer and Wayland.
 +
:: 📄 '''Linux Interface Specification Yocto recipe Start-Up Guide''' - Building with Yocto, programming boot loaders and BSP Memory Map
 +
* <font size=+3>🎥</font>'''[[RZ-G/RZG2_videos | Demo Videos (link)]]'''
  
 +
== RZ/G2 BSP and Yocto ==
 +
* '''Downloads'''
 
{| class="wikitable"
 
{| class="wikitable"
|+ Renesas RZ/G evaluation boards
+
|- style="vertical-align: top;"
|-
+
|
 +
|'''VLP64 v1.0.4'''
 +
|'''VLP64 v1.0.5-RT'''
 +
|'''VLP64 v1.0.6'''
 +
|'''VLP64 v1.0.7-RT'''
 +
|- style="vertical-align: top;"
 +
|📦 '''RZ/G Verified Linux Package for 64bit kernel''' <br> This is the actual Yocto BSP
 +
|💾 [https://www.renesas.com/eu/en/document/esw/rzg-verified-linux-package-64bit-kernel-419-cip-v104 (link)]
 +
|💾 [https://www.renesas.com/eu/en/document/esw/rzg-verified-linux-package-64bit-kernel-419-cip-rt-v105-rt (link)]
 +
|💾 [https://www.renesas.com/document/esw/yocto-recipe-packages-vlp64-v106?language=en (link)]
 +
|💾 [https://www.renesas.com/document/esw/yocto-recipe-packages-vlp64-v107-rt-rzg2bspevav107rttargz?language=en (link)]
 +
|- style="vertical-align: top;"
 +
|📦 '''Release note for RZ/G Verified Linux Package''' <br>  Build instructions, start with this document
 +
|📄 [https://www.renesas.com/eu/en/document/rln/release-note-rzg-verified-linux-package-64bit-kernel-v104 (link)]
 +
|📄 [https://www.renesas.com/eu/en/document/rln/release-note-rzg-verified-linux-package-64bit-kernel-v105-rt-0?language=en (link)]
 +
|📄 [https://www.renesas.com/us/en/document/rln/release-note-rzg-verified-linux-package-64bit-kernel-v106?language=en (link)]
 +
|📄 [https://www.renesas.com/document/rln/release-note-rzg-verified-linux-package-64bit-kernel-v107-rt?language=en (link)]
 +
|- style="vertical-align: top;"
 +
|📦 '''RZ/G2 Reference Boards Linux Start-up Guide''' <br>  How to program the boot loaders into SPI flash
 +
|📄 [https://www.renesas.com/eu/en/document/rln/rzg2-reference-boards-linux-start-guide (link)]
 +
|
 +
|📄 [https://www.renesas.com/eu/en/document/rln/rzg2-reference-boards-linux-start-guide-0?language=en (link)]
 +
|📄 [https://www.renesas.com/document/rln/rzg2-reference-boards-start-guide-1?language=en  (link)]
 +
|- style="vertical-align: top;"
 +
|📦 '''Release Note for HTML5''' <br> Building the HTML5 browser using the BSP requires a different set of instructions
 +
|📄 [https://www.renesas.com/eu/en/document/rln/rzg-verified-linux-package-64bit-kernel-v104-release-note-html5 (link)]
 +
|📄 [https://www.renesas.com/eu/en/document/rln/rzg-verified-linux-package-64bit-kernel-v105-rt-release-note-html5-0 (link)]
 +
|📄 [https://www.renesas.com/eu/en/document/rln/rzg-verified-linux-package-64bit-kernel-v106-release-note-html5?language=en (link)]
 +
|📄 [https://www.renesas.com/document/rln/rzg-verified-linux-package-64bit-kernel-v107-rt-release-note-html5?language=en (link)]
 +
|- style="vertical-align: top;"
 +
|📦 '''VLP64 Component list''' <br> List of each package and version included in the default BSP build
 
|
 
|
|'''Low Cost Boards (LCB)'''
+
|📄 [https://www.renesas.com/eu/en/document/rln/rzg-verified-linux-package-64bit-kernel-version-105-rt-component-list?language=en (link)]
|-
+
|📄 [https://www.renesas.com/eu/en/document/rln/rzg-verified-linux-package-64bit-kernel-v106-component-list?language=en (link)]
|'''RZ/G1M'''
+
|📄 [https://www.renesas.com/document/rln/rzg-verified-linux-package-64bit-kernel-v107-rt-component-list?language=en  (link)]
|[[File:65px-G1M_top.png|65px|link=RZ-G/Boards/SK-RZG1M]]<br/>[[RZ-G/Boards/SK-RZG1M | RZ/G1M Starter Kit]]
+
|- style="vertical-align: top;"
|-
+
|📦 '''RZ/G2 Group BSP Manual Set''' <br> Detailed information about Device Drivers and Device Tree Settings
|-
+
|📄 [https://www.renesas.com/eu/en/document/rzg2-group-bsp-manual-set?language=en (link)]
|'''RZ/G1E'''
+
|📄 [https://www.renesas.com/eu/en/document/rzg2-group-bsp-manual-set?language=en (link)]
| [[File:65px-G1E_top.png|65px|link=RZ-G/Boards/SK-RZG1E]]<br/>[[RZ-G/Boards/SK-RZG1E | RZ/G1E Starter Kit]]
+
|📄 [https://www.renesas.com/eu/en/document/rzg2-group-bsp-manual-set?language=en (link)]
 +
|📄 [https://www.renesas.com/eu/en/document/rzg2-group-bsp-manual-set?language=en (link)]
 
|}
 
|}
  
= RZ/G Yocto Linux =
+
* '''Information'''
The Linux BSP for RZ/G is built using the Yocto/Openembedded project.
+
: <font size=+3>🛠️</font> '''[[RZ-G/RZG2_BSP | RZ/G2 BSP (link)]]''' (Updates, known issues, bug fixes)
 +
: <font size=+3>📖</font> '''[[RZ-G/RZG2_yocto | RZ/G2 Yocto (link)]]''' (Common issues, suggestions, examples)
  
== Build instructions ==
+
== RZ/G2 Graphics and Camera ==
Detailed build instructions are available here: [[RZ-G/Boards/Yocto]].
+
* <font size=+3>🎨</font> '''[[RZ-G/RZG2_graphics | RZ/G2 Graphics (link)]]''' (Qt, video encode/decode)
 +
* <font size=+3>📷</font> '''[[RZ-G/RZG2_camera | RZ/G2 Camera (link)]]''' (MIPI camera)
 +
* <font size=+3>🖼️</font> '''[[RZ-G/RZG_weston | Weston (link)]]''' (Helpful hints about running Weston with RZ/G)
  
== Quick steps ==
+
== RZ/G2 Boot Loaders ==
To get started, pull the https://github.com/renesas-rz/meta-renesas tree.
+
* <font size=+3>🔑</font> '''[[RZ-G/RZG2_arm_trusted_firmware | RZ/G2 ARM Trusted Firmware (link)]]'''
 +
* <font size=+3>🥾</font> '''[[RZ-G/RZG2_uboot | RZ/G2 u-boot (link)]]'''
  
Update bblayers.conf by adding the the meta-renesas and meta-rzg1 layers. e.g.:
+
== RZ/G2 Kernel ==
 +
* <font size=+3>🐧</font> '''[[RZ-G/RZG2_kernel | RZ/G2 Kernel (link)]]''' (Dynamic Power, drivers, peripherals, etc..)
 +
* <font size=+3>🐧</font> '''[[RZ-G/BSP_upgrade | Update your BSP kernel (link)]]''' (Instructions on how to update your BSP kernel)
 +
* <font size=+3>🐧</font> '''[[RZ-G/RZG2_pcie_ep | RZ/G2 PCIe EP (link)]]''' (PCIe EP driver)
  
        BBLAYERS ?= " \
+
== RZ/G2 Debug ==
                <path to layer>/poky/meta \
+
* <font size=+3>🐛🔨</font> '''[[RZ-G/RZG2_openocd | RZ/G2 OpenOCD (link)]]'''
                <path to layer>/poky/meta-yocto \
 
                <path to layer>/poky/meta-yocto-bsp \
 
                <path to layer>/meta-renesas \
 
                <path to layer>/meta-renesas/meta-rzg1 \
 
        "
 
  
Specify the associated machine in local.conf:
 
  
        MACHINE ?= "<supported board name>" (skrzg1m skrzg1e)
+
= [[File:Board2.jpg|link=|caption]] RZ/G1 Boards =
 +
Here is the list of official [https://www.renesas.com/us/en/products/rzg-linux-platform/rzg-marcketplace/board-solutions.html Renesas Evaluation Boards (link)]
  
Setup be build environment using the 'oe-init-build-env' script in Poky:
+
{| class="wikitable" style="border: none; background: none;"
 
+
|+ Renesas RZ/G1 Evaluation Boards
        $ source poky/oe-init-build-env
+
|- style="vertical-align: top;"
 
+
|'''RZ/G1E'''<br>R8A7745
Build the target file system image using bitbake:
+
| '''iWave RZ/G1E SODIMM'''<br> ♦ [https://www.iwavesystems.com/rz-g1e-sodimm-development-kit.html Product page] <br> ♦ [https://www.renesas.com/us/en/products/rzg-linux-platform/rzg-marcketplace/verified-linux-package.html Linux Package for 32-bit RZ/G1] <br> (Build instructions in "Release Note" of BSP)
 
+
| '''RZ/G1E Starter Kit''' <br> ♦ [[RZ-G/Boards/SK-RZG1E | Board Info]] <br> ♦ [[RZ-G/Boards/Yocto|RZ/G1 SK Build Instructions]]
        $ bitbake core-image-minimal
+
|- style="vertical-align: top;"
 
+
|'''RZ/G1M'''<br>R8A7743
= RZ/G Linux Kernel =
+
| '''iWave RZ/G1M SODIMM'''<br> ♦ [https://www.iwavesystems.com/rz-g1e-sodimm-development-kit.html Product page] <br> ♦ [https://www.renesas.com/us/en/products/rzg-linux-platform/rzg-marcketplace/verified-linux-package.html Linux Package for 32-bit RZ/G1] <br> (Build instructions in "Release Note" of BSP)
 
+
| '''RZ/GM Starter Kit'''  <br> ♦[[RZ-G/Boards/SK-RZG1M | Board Info]] <br> ♦ [[RZ-G/Boards/Yocto|RZ/G1 SK Build Instructions]]
== Upstream ==
+
|- style="vertical-align: top;"
 
+
|'''RZ/G1N'''<br>R8A7744
The Linux kernel mainline tree for Renesas R-Car and RZ/G SoCs is maintained by [http://horms.org/about_me.shtml Simon Horman]
+
| '''iWave RZ/G1N SODIMM'''<br> ♦ [https://www.iwavesystems.com/rz-g1m-qseven-development-kit.html Product Page] ♦ [https://www.renesas.com/us/en/products/rzg-linux-platform/rzg-marcketplace/verified-linux-package.html Linux Package for 32-bit RZ/G1] <br> (Build instructions in "Release Note" of BSP)
 
+
|- style="vertical-align: top;"
Start here to get latest/closest upstream kernel:
+
|'''RZ/G1H'''<br>R8A7742
git://git.kernel.org/pub/scm/linux/kernel/git/horms/renesas.git
+
| '''iWave RZ/G1H SODIMM'''<br> ♦ [https://www.iwavesystems.com/rz-g1h-q7-development-kit.html Product Page] ♦ [https://www.renesas.com/us/en/products/rzg-linux-platform/rzg-marcketplace/verified-linux-package.html Linux Package for 32-bit RZ/G1] <br> (Build instructions in "Release Note" of BSP)
 
+
|}
== RZ/G Community==
 
*Mailing list - via kernel.org [mailto:majordomo@vger.kernel.org?body=subscribe linux-sh Majordomo].
 
Archives available here: http://marc.info/?l=linux-sh , http://dir.gmane.org/gmane.linux.ports.sh.devel , http://www.spinics.net/lists/linux-sh/
 
 
 
== LTSI (Long Term Support Initiative) ==
 
 
 
Renesas SoCs and boards are supported as part of the LTSI project - http://ltsi.linuxfoundation.org/ . Refer to [http://ltsi.linuxfoundation.org/releases/ltsi-tree/3.10.31-ltsi/stable-release 3.10] and [http://ltsi.linuxfoundation.org/releases/ltsi-tree/3.14.24-rc1-ltsi/release-candidate 3.14] baselines
 
 
 
== Renesas Stable RZ/G Linux Tree ==
 
 
 
Stable Renesas R-Car and RZ/G Linux tree located here: git://git.kernel.org/pub/scm/linux/kernel/git/horms/renesas-backport.git. Pull latest stable branch.
 
 
 
for example: bsp/v3.10.31-ltsi/rcar-gen2-1.9.7
 
 
 
= RZ/G U-Boot =
 
 
 
RZ/G U-Boot mainline development is done using git://git.denx.de/u-boot-sh.git tree. It is maintained by Nobuhiro Iwamatsu.
 
 
 
for example: renesas/bsp/rcar-gen2-1.9.4
 
 
 
= RZ/G Android =
 
 
 
TBD
 

Revision as of 10:59, 15 April 2021

💡 Introduction

This is the starting page for Embedded Linux on the Renesas RZ/G family of embedded SoCs. The main goal is to make the information about RZ/G SoCs friendly, easy to access for embedded developers and enthusiasts. It does not aim to replace official Renesas support.

The links below can be used to get familiar with Renesas RZ/G SoC

Detailed information regarding RZ/G SoCs (including roadmap, technical and marketing documents, BSPs and middleware) can be obtained directly from a Renesas representative.


caption RZ/G2 Boards

Here is the list of available Renesas Evaluation Boards (link) and commercial SOM boards.

Renesas RZ/G2 Boards
RZ/G2E
R8A774C
Silicon Linux EK874
📄 Product page (Silicon Linux)
📄 Product page (Renesas)
🛠️ EK874 Board Info and FAQ
RZ/G2M
R8A774A
RZ/G2M HiHope
📄 Product page
🛠️ HiHope Board Info and FAQ
🛒 Amazon Link
RZ/G2N
R8A774B
RZ/G2N HiHope
📄 Product page
🛠️ HiHope Board Info and FAQ
🛒 Amazon Link
RZ/G2H
R8A774E
RZ/G2H HiHope
📄 Product page
🛠️ HiHope Board Info and FAQ

💡 RZ/G2 FAQ Section

Online Documents

📄 (example documents on that page)
📄 RZ/G2 Group Linux BSP Porting Guide - How to modify the Renesas BSP to match your board
📄 RZ/G2 Group BSP Manual Set - Information about BSP device drivers and Device Tree configurations. It also contains information regarding GStreamer and Wayland.
📄 Linux Interface Specification Yocto recipe Start-Up Guide - Building with Yocto, programming boot loaders and BSP Memory Map

RZ/G2 BSP and Yocto

  • Downloads
VLP64 v1.0.4 VLP64 v1.0.5-RT VLP64 v1.0.6 VLP64 v1.0.7-RT
📦 RZ/G Verified Linux Package for 64bit kernel
This is the actual Yocto BSP
💾 (link) 💾 (link) 💾 (link) 💾 (link)
📦 Release note for RZ/G Verified Linux Package
Build instructions, start with this document
📄 (link) 📄 (link) 📄 (link) 📄 (link)
📦 RZ/G2 Reference Boards Linux Start-up Guide
How to program the boot loaders into SPI flash
📄 (link) 📄 (link) 📄 (link)
📦 Release Note for HTML5
Building the HTML5 browser using the BSP requires a different set of instructions
📄 (link) 📄 (link) 📄 (link) 📄 (link)
📦 VLP64 Component list
List of each package and version included in the default BSP build
📄 (link) 📄 (link) 📄 (link)
📦 RZ/G2 Group BSP Manual Set
Detailed information about Device Drivers and Device Tree Settings
📄 (link) 📄 (link) 📄 (link) 📄 (link)
  • Information
🛠️ RZ/G2 BSP (link) (Updates, known issues, bug fixes)
📖 RZ/G2 Yocto (link) (Common issues, suggestions, examples)

RZ/G2 Graphics and Camera

RZ/G2 Boot Loaders

RZ/G2 Kernel

RZ/G2 Debug


caption RZ/G1 Boards

Here is the list of official Renesas Evaluation Boards (link)

Renesas RZ/G1 Evaluation Boards
RZ/G1E
R8A7745
iWave RZ/G1E SODIMM
Product page
Linux Package for 32-bit RZ/G1
(Build instructions in "Release Note" of BSP)
RZ/G1E Starter Kit
Board Info
RZ/G1 SK Build Instructions
RZ/G1M
R8A7743
iWave RZ/G1M SODIMM
Product page
Linux Package for 32-bit RZ/G1
(Build instructions in "Release Note" of BSP)
RZ/GM Starter Kit
Board Info
RZ/G1 SK Build Instructions
RZ/G1N
R8A7744
iWave RZ/G1N SODIMM
Product PageLinux Package for 32-bit RZ/G1
(Build instructions in "Release Note" of BSP)
RZ/G1H
R8A7742
iWave RZ/G1H SODIMM
Product PageLinux Package for 32-bit RZ/G1
(Build instructions in "Release Note" of BSP)