RZ-G/RZ-G2 BSP: Difference between revisions

From Renesas.info
(Remove section [Fix the VLP64 v1.0.5-RT SDK Toolchain])
(Remove [VLP64 v1.0.6], [VLP64 v1.0.7-RT] [ RZ/G2L 1.0])
Line 4: Line 4:
= Downloads =
= Downloads =
* <font size=+2>'''RZ/G2E, RZ/G2N, RZ/G2M, RZ/G2H'''</font>
* <font size=+2>'''RZ/G2E, RZ/G2N, RZ/G2M, RZ/G2H'''</font>
* <font size=+1> [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-cortex-a-mpus/rzg-linux-platform/rzg-marketplace/verified-linux-package Official RZ/G2 BSP Download Page] </font>
* <font size=+1> ⭐ [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-cortex-a-mpus/rzg-linux-platform/rzg-marketplace/verified-linux-package Official RZ/G2 BSP Download Page] </font>
{| class="wikitable"
{| class="wikitable"
|- style="vertical-align: top;"
|- style="vertical-align: top;"
|
|
|'''VLP64 v1.0.6'''
|'''VLP64 v1.0.7-RT'''
|'''VLP64 v1.0.8'''
|'''VLP64 v1.0.8'''
|'''VLP64 v1.0.9-RT'''
|'''VLP64 v1.0.9-RT'''
Line 15: Line 13:
|- style="vertical-align: top;"
|- style="vertical-align: top;"
|πŸ“¦ '''RZ/G2 Linux Package (Complete Download)''' <br> ZIP file containing Yocto BSP and all documentation
|πŸ“¦ '''RZ/G2 Linux Package (Complete Download)''' <br> ZIP file containing Yocto BSP and all documentation
|
|
|πŸ’Ύ [https://www.renesas.com/us/en/document/esw/rzg-verified-linux-package-64bit-kernel-v108-rtk0ef0045z0011azj-v108zip?r=1163891 (link)]
|πŸ’Ύ [https://www.renesas.com/us/en/document/esw/rzg-verified-linux-package-64bit-kernel-v108-rtk0ef0045z0011azj-v108zip?r=1163891 (link)]
|πŸ’Ύ [https://www.renesas.com/us/en/document/swe/rzg-verified-linux-package-64bit-kernel-v109-rt-rtk0ef0045z0011azj-v109rtzip?r=1163946 (link)]
|πŸ’Ύ [https://www.renesas.com/us/en/document/swe/rzg-verified-linux-package-64bit-kernel-v109-rt-rtk0ef0045z0011azj-v109rtzip?r=1163946 (link)]
Line 22: Line 18:
|- style="vertical-align: top;"
|- style="vertical-align: top;"
|πŸ“¦ '''Yocto Recipe''' <br> This is the actual BSP provided in a Yocto build package
|πŸ“¦ '''Yocto Recipe''' <br> This is the actual BSP provided in a Yocto build package
|πŸ’Ύ [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)]
| <center>⬆</center>
| <center>⬆</center>
| <center>⬆</center>
| <center>⬆</center>
Line 29: Line 23:
|- style="vertical-align: top;"
|- style="vertical-align: top;"
|πŸ“¦ '''Release Note for Linux Package''' <br>Β  Build instructions, start with this document
|πŸ“¦ '''Release Note for Linux Package''' <br>Β  Build instructions, start with this document
|πŸ“„ [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)]
| <center>⬆</center>
| <center>⬆</center>
| <center>⬆</center>
| <center>⬆</center>
Line 36: Line 28:
|- style="vertical-align: top;"
|- style="vertical-align: top;"
|πŸ“¦ '''Reference Boards Linux Start-up Guide''' <br>Β  How to program the boot loaders into SPI flash
|πŸ“¦ '''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-0?language=en (link)]
|πŸ“„ [https://www.renesas.com/document/rln/rzg2-reference-boards-start-guide-1?language=enΒ  (link)]
| <center>⬆</center>
| <center>⬆</center>
| <center>⬆</center>
| <center>⬆</center>
Line 43: Line 33:
|- style="vertical-align: top;"
|- style="vertical-align: top;"
|πŸ“¦ '''Release Note for HTML5 Linux Package''' <br> Building the HTML5 browser using the BSP requires a different set of instructions
|πŸ“¦ '''Release Note for HTML5 Linux Package''' <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-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)]
| <center>⬆</center>
| <center>⬆</center>
| <center>⬆</center>
| <center>⬆</center>
Line 50: Line 38:
|- style="vertical-align: top;"
|- style="vertical-align: top;"
|πŸ“¦ '''BSP Component list''' <br> List of each package and version included in the default BSP build
|πŸ“¦ '''BSP Component list''' <br> List of each package and version included in the default BSP build
|πŸ“„ [https://www.renesas.com/eu/en/document/rln/rzg-verified-linux-package-64bit-kernel-v106-component-list?language=en (link)]
|πŸ“„ [https://www.renesas.com/document/rln/rzg-verified-linux-package-64bit-kernel-v107-rt-component-list?language=en (link)]
| <center>⬆</center>
| <center>⬆</center>
| <center>⬆</center>
| <center>⬆</center>
Line 57: Line 43:
|- style="vertical-align: top;"
|- style="vertical-align: top;"
|πŸ“¦ '''RZ/G2 Group BSP Manual Set''' <br> Detailed information about Device Drivers and Device Tree Settings
|πŸ“¦ '''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)]
|πŸ“„ [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)]
|πŸ“„ [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)]
|πŸ“„ [https://www.renesas.com/eu/en/document/rzg2-group-bsp-manual-set?language=en (link)]
Line 67: Line 51:


* <font size=+2>'''RZ/G2L'''</font>
* <font size=+2>'''RZ/G2L'''</font>
* <font size=+1> [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-board-support-package-419-cip Official RZ/G2L BSP Download Page] </font>
* <font size=+1> ⭐ [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-board-support-package-419-cip Official RZ/G2L BSP Download Page] </font>
{| class="wikitable"
{| class="wikitable"
|- style="vertical-align: top;"
|- style="vertical-align: top;"
|
|
|'''BSP v1.0'''
|'''BSP v1.1'''
|'''BSP v1.1'''
|'''BSP v1.3'''
|'''BSP v1.3'''
|- style="vertical-align: top;"
|- style="vertical-align: top;"
|πŸ“¦ '''RZ/G2L Linux Package''' <br> ● '''Yocto BSP''' <br> ● '''Release Note''' <br> &emsp; β—‹ Build instructions, start with this document <br> ● '''RZ/G2L Reference Board Start-up Guide''' <br> &emsp; β—‹ How to program the boot loaders into SPI flash <br> ● '''BSP Component list''' <br> &emsp; β—‹ List of each package and version included in the default BSP build
|πŸ“¦ '''RZ/G2L Linux Package''' <br> ● '''Yocto BSP''' <br> ● '''Release Note''' <br> &emsp; β—‹ Build instructions, start with this document <br> ● '''RZ/G2L Reference Board Start-up Guide''' <br> &emsp; β—‹ How to program the boot loaders into SPI flash <br> ● '''BSP Component list''' <br> &emsp; β—‹ List of each package and version included in the default BSP build
|πŸ’Ύ [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-board-support-package-419-cip (link)]
|πŸ’Ύ [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-board-support-package-419-cip (link)]
|πŸ’Ύ [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-board-support-package-419-cip (link)]
|πŸ’Ύ [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-board-support-package-419-cip (link)]
|πŸ’Ύ [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-board-support-package-419-cip (link)]
|- style="vertical-align: top;"
|- style="vertical-align: top;"
|πŸ“¦ '''RZ/G2L Mali Graphic Library''' <br> ● Files to be added to the Yocto BSP to enable Graphics
|πŸ“¦ '''RZ/G2L Mali Graphic Library''' <br> ● Files to be added to the Yocto BSP to enable Graphics
|
| v0.51 <br> πŸ’Ύ [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-mali-graphic-library-evaluation-version (link)]
| v0.51 <br> πŸ’Ύ [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-mali-graphic-library-evaluation-version (link)]
| v0.8 <br> πŸ’Ύ [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-mali-graphic-library-evaluation-version (link)]
| v0.8 <br> πŸ’Ύ [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-mali-graphic-library-evaluation-version (link)]
|- style="vertical-align: top;"
|- style="vertical-align: top;"
|πŸ“¦ '''RZ/G2L Video Codec Library''' <br> ● Files to be added to the Yocto BSP to enable H.264 Video Encode/Decode
|πŸ“¦ '''RZ/G2L Video Codec Library''' <br> ● Files to be added to the Yocto BSP to enable H.264 Video Encode/Decode
|
|
|
| v0.51 <br> πŸ’Ύ [https://www.renesas.com/us/en/document/swe/codec-library-evaluation-version-v051-rzg2l-group-board-support-package?language=en (link)]
| v0.51 <br> πŸ’Ύ [https://www.renesas.com/us/en/document/swe/codec-library-evaluation-version-v051-rzg2l-group-board-support-package?language=en (link)]
|- style="vertical-align: top;"
|- style="vertical-align: top;"
|πŸ“¦ '''RZ/G2L Group BSP Manual Set''' <br> ● Detailed information about Device Drivers and Device Tree Settings
|πŸ“¦ '''RZ/G2L Group BSP Manual Set''' <br> ● Detailed information about Device Drivers and Device Tree Settings
|
|πŸ“„ [https://www.renesas.com/document/oth/rzg2l-group-bsp-manual-set-rev101?language=en (link)]
|πŸ“„ [https://www.renesas.com/document/oth/rzg2l-group-bsp-manual-set-rev101?language=en (link)]
|πŸ“„ [https://www.renesas.com/document/oth/rzg2l-group-bsp-manual-set-rev101?language=en (link)]
|πŸ“„ [https://www.renesas.com/document/oth/rzg2l-group-bsp-manual-set-rev101?language=en (link)]
|- style="vertical-align: top;"
|- style="vertical-align: top;"
|πŸ“¦ '''RZ/G2L Multi-OS Package (CM33)''' <br> ● FreeRTOS for CM33 and OpenAMP comms between A55 and CM33
|πŸ“¦ '''RZ/G2L Multi-OS Package (CM33)''' <br> ● FreeRTOS for CM33 and OpenAMP comms between A55 and CM33
|
|πŸ“„ [https://www.renesas.com/jp/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-multi-os-package (link)]
|πŸ“„ [https://www.renesas.com/jp/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-multi-os-package (link)]
|πŸ“„ [https://www.renesas.com/jp/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-multi-os-package (link)]
|πŸ“„ [https://www.renesas.com/jp/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-multi-os-package (link)]

Revision as of 13:06, 1 December 2021

← RZ-G

Downloads

VLP64 v1.0.8 VLP64 v1.0.9-RT VLP64 v1.0.10
πŸ“¦ RZ/G2 Linux Package (Complete Download)
ZIP file containing Yocto BSP and all documentation
πŸ’Ύ (link) πŸ’Ύ (link) πŸ’Ύ (link)
πŸ“¦ Yocto Recipe
This is the actual BSP provided in a Yocto build package
⬆
⬆
⬆
πŸ“¦ Release Note for Linux Package
Build instructions, start with this document
⬆
⬆
⬆
πŸ“¦ Reference Boards Linux Start-up Guide
How to program the boot loaders into SPI flash
⬆
⬆
⬆
πŸ“¦ Release Note for HTML5 Linux Package
Building the HTML5 browser using the BSP requires a different set of instructions
⬆
⬆
⬆
πŸ“¦ BSP Component list
List of each package and version included in the default BSP build
⬆
⬆
⬆
πŸ“¦ RZ/G2 Group BSP Manual Set
Detailed information about Device Drivers and Device Tree Settings
πŸ“„ (link) πŸ“„ (link) πŸ“„ (link)


BSP v1.1 BSP v1.3
πŸ“¦ RZ/G2L Linux Package
● Yocto BSP
● Release Note
  β—‹ Build instructions, start with this document
● RZ/G2L Reference Board Start-up Guide
  β—‹ How to program the boot loaders into SPI flash
● BSP Component list
  β—‹ List of each package and version included in the default BSP build
πŸ’Ύ (link) πŸ’Ύ (link)
πŸ“¦ RZ/G2L Mali Graphic Library
● Files to be added to the Yocto BSP to enable Graphics
v0.51
πŸ’Ύ (link)
v0.8
πŸ’Ύ (link)
πŸ“¦ RZ/G2L Video Codec Library
● Files to be added to the Yocto BSP to enable H.264 Video Encode/Decode
v0.51
πŸ’Ύ (link)
πŸ“¦ RZ/G2L Group BSP Manual Set
● Detailed information about Device Drivers and Device Tree Settings
πŸ“„ (link) πŸ“„ (link)
πŸ“¦ RZ/G2L Multi-OS Package (CM33)
● FreeRTOS for CM33 and OpenAMP comms between A55 and CM33
πŸ“„ (link) πŸ“„ (link)

This page discusses topics specific to the content and code released in the BSP. Information on using the BSP is found on other pages such as RZ-G/RZG_yocto.

BSP Differences Between renesas.com Download and Github Version

Below are the differences between BSP you download from renesas.com and what is available on public repositories.

Public Repository Clones

  • meta-gplv2/
  • meta-linaro/
  • meta-openembedded/
  • meta-qt5/
  • meta-rzg2/
  • meta-virtualization/
  • poky/

These directories are direct clones (no modifications) from public repositories. The repository URLs and commit IDs that were used are documented in the README.md file in the meta-rzg2 directory in the BSP.


Example Layers

  • meta-hmi-custom/
  • meta-userboard/

These directories do not have any functionally. They are simple example templates you can use to make your own customer layers. They are only included in the renesas.com package.


The RZ/G2 BSP

  • meta-rzg2/

Basically, all the customizations and patches are located in the directory 'meta-rzg2'.
This directory is a clone of the public repository is located here: https://github.com/renesas-rz/meta-rzg2.
There are git tags for BSP version that was release.
The only difference is that in the renesas.com version, the following lines were added to the local.conf files under docs/sample/conf

DL_DIR = "${TOPDIR}/oss_packages"
BB_NO_NETWORK = "0"

Additionally, other configuration files such as bblayers_gecko.conf and local_gecko.con are added to the renesas.com download that are not in the github version.


Non-public Patches

  • extra/

This directory is only in the package downloaded from renesas.com
It contains patches that are not included in the public the meta-rzg2 repository on github. For example, the patches to enable HDMI on the boards were not posted to github because of potential license issues.


Video and Multi-media Drivers

  • proprietary/

This directory is only in the package downloaded from renesas.com
This directory contains .zip files which are essentially the propriety closed source video and multimedia drivers. They used to be downloaded separately, but are now included when downloaded the BSP from renesas.com. When following the instructions in the "Renesas Note" that comes with the BSP, users will run the script copy_proprietary_softwares.sh which will unpack these zip files into various directories under meta-rzg2.

Fix RZ/G2H eMMC boot for VLP64 v1.0.5-RT and v1.0.6

For the BSP releases of v1.0.5-RT and v1.0.6, a patch in the arm-trusted-firmware code was missing for RZ/G2H that prevented it from booting from eMMC. While RZ/G2H eMMC boot support exists in v1.0.4, for the v1.0.5 code release, the base software repository changed from the R-Car repository to the official ARM repository and new "rzg" subdirectory were created. With all these changes, this eMMC boot patch was unfortunately missed.

Please apply the patch below to your arm-trusted-firmware code base if you are using a RZ/G2H and require booting from eMMC.

Note: The same patch file can be used for all variations of v1.0.5 and v1.0.6 releases

$ wget https://raw.githubusercontent.com/seebe/rzg_stuff/master/build_scripts/vlp64_patches/BSP-1.0.5-RT/arm-trusted-firmware/fix-G2H-eMMC-boot_patch/0001-hihope-rzg2h-pfc-update.patch

Fix broken links to video files for VLP64 v1.0.5-RT and v1.0.6

The Renesas.com website was recently changed, and now the links for the sample video movies for the Yocto recipes-demos have become broken.

A patch to the meta-rzg2 Yocto layer is required to fix the URL.

Note: The same patch file can be used for all variations of v1.0.5 and v1.0.6 releases.

$ rzg2_bsp_eva_v106/meta-rzg2
$ wget https://raw.githubusercontent.com/seebe/rzg_stuff/master/build_scripts/vlp64_patches/BSP-1.0.6/meta-rzg2/fix-URL-change-of-video-files/0001-recipes-demos-hmi-demo-videos-update-URLs-of-video-f.patch
$ patch -p1 -i 0001-recipes-demos*.patch

SPI Flash Driver for BSP 1.0.6

SPI flash write from Linux is not officially supported in V1.0.6 BSP. If you want SPI write enabled for BSP 1.0.6. Please follow the below steps:

1. Add kernel patches to BSP

1.a) Please get required patch files from https://github.com/seebe/rzg_stuff/tree/master/build_scripts/vlp64_patches/BSP-1.0.6-SPI-write/kernel

$ rzg2_bsp_eva_v106/recipes-kernel/linux/linux-renesas/patches
$ mkdir v1.0.6_spi_patch
$ cd v1.0.6_spi_patch #copy patch files here

1.b) Update patches.scc file:

Yocto uses .scc file to apply patches located in ~/rzg2_bsp_eva_v106/meta-rzg2/recipes-kernel/linux/linux-renesas/patches.scc. Get updated .scc file from https://github.com/seebe/rzg_stuff/tree/master/build_scripts/vlp64_patches/BSP-1.0.6-SPI-write/

$ cd ~/rzg2_bsp_eva_v106/meta-rzg2/recipes-kernel/linux/linux-renesas/
$ wget https://raw.githubusercontent.com/seebe/rzg_stuff/master/build_scripts/vlp64_patches/BSP-1.0.6-SPI-write/patches.scc

2. Configuring kernel using menuconfig

Configure the kernel to enable Renesas SPI driver and SPI memory. The following commands initialize the BitBake environment, run the do_kernel_configme task, and launch menuconfig. These commands assume the Source Directory's top-level folder is ~/rzg2_bsp_eva_v106:

$ cd rzg2_bsp_eva_v106
$ source poky/oe-init-build-env
$ bitbake linux-renesas -c kernel_configme -f
$ bitbake linux-renesas -c menuconfig

Once menuconfig comes up, configure below kernel configuration parameters.

2.a)Enable Renesa RPC-IF driver:

.config - Linux/arm64 4.19.140 Kernel Configuration
 > Device Drivers > Memory Controller drivers

2.b)Enable SPI memory (M25P80 ):

.config - Linux/arm64 4.19.140 Kernel Configuration
 > Device Drivers > Memory Technology Device (MTD) support > Self-contained MTD device drivers 

After making your changes, simply exit the tool and save your changes to create an updated version of the .config configuration file

3. Build the image using updated BSP