RZ/G2 BSP Information Page

From Renesas.info
Jump to navigation Jump to search

← RZ-G

Overview

VLP Diagram
  • The Renesas BSPs for MPUs are distributed as Yocto builds.
  • Renesas specific portions (boot loader, kernel, etc..) are store in github which is where the Yocto recipes pull from.
  • Additional Yocto patch files are included in the renesas.com download packages that you will not find on github.
  • Some libraries (graphics and video codecs) are proprietary can only be downloaded from renesas.com after registering.
  • For the structure of the BSPs, there are a common Yocto layers that are used to build most Renesas software for each MPU. However, additional 'optional' software components are distributed and downloaded as "Features". There is a meta-rz-features Yocto layer directory where individual Yocto recipes can be added to a build if needed.
  • The diagram on the right shows the common Yocto build in blue, and the optional Feature Packages that can be added. (Click for full size)


Downloads

Linux 5.10 BSP for all RZ/G2 Devices

  • RZ/G2L, RZ/G2LC, RZ/G2UL, RZ/G2E, RZ/G2N, RZ/G2M, RZ/G2H
  • ⭐ Official RZ/G2 BSP Download Page
  • Please Download the individual components required for your MPU.
  • Please use the package versions listed table. You must match the correct component packages (Graphic, Codec) versions with the BSP version you are using.
RZ/G VLP v3.0.0 RZ/G VLP v3.0.0-update1
πŸ“¦ RZ/G2 Linux Package (Common for all MPU)
ZIP file containing Yocto BSP and all documentation
  • 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
πŸ’Ύ (link) πŸ’Ύ (link)
Graphics and H.264/H.265 Video Codec libraries for RZ/G2H, RZ/G2M, RZ/G2N, and RZ/G2E πŸ’Ύ V1.0 (direct link)
πŸ—¨οΈ V1.0 (info page)
πŸ’Ύ V1.0 (direct link)
πŸ—¨οΈ V1.0 (info page)
Graphics libraries for the Mali GPU in RZ/G2L, RZ/G2LC, and RZ/V2L πŸ’Ύ V1.0 (direct link)
πŸ—¨οΈ (info page)
πŸ’Ύ V1.1 (direct link)
πŸ—¨οΈ (info page)
Video Codec libraries for the Video Codec in RZ/G2L and RZ/V2L πŸ’Ύ V0.56 (direct link)
πŸ—¨οΈ (info page)
πŸ’Ύ V0.57 (direct link)
πŸ—¨οΈ (info page)
πŸ“¦ RZ/G2 Group BSP Manual Set
Detailed information about Device Drivers and Device Tree Settings
πŸ“„ (link) πŸ“„ (link)

Linux 4.19 BSP for RZ/G2E, RZ/G2N, RZ/G2M, RZ/G2H

  • RZ/G2E, RZ/G2N, RZ/G2M, RZ/G2H
  • ⭐ Official RZ/G2 BSP Download Page
    • The Evaluation Version can be downloaded immediately, but there is a timeout on the proprietary graphics and video codec libraries.
    • The Product Version is available at the bottom of the page, and the timeout is removed, but due to license processing, it requires 1 to 2 weeks before download.
VLP64 v1.0.8 VLP64 v1.0.9-RT VLP64 v1.0.10 VLP64 v1.0.11-RT VLP64 v1.0.12
πŸ“¦ RZ/G2 Linux Package (Complete Download)
ZIP file containing Yocto BSP and all documentation
  • 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
πŸ’Ύ (link) πŸ’Ύ (link) πŸ’Ύ (link) πŸ’Ύ (link) πŸ’Ύ (link)
πŸ“¦ RZ/G2 Group BSP Manual Set
Detailed information about Device Drivers and Device Tree Settings
πŸ“„ (link) πŸ“„ (link) πŸ“„ (link) πŸ“„ (link) πŸ“„ (link)


Linux 4.19 BSP for RZ/G2L, RZ/G2LC, RZ/G2UL

BSP v1.3 BSP v1.4
πŸ“¦ 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)

(direct link to zip)
πŸ“¦ RZ/G2L Mali Graphic Library (Evaluation Version)(Recommended)
● Files to be added to the Yocto BSP to enable Graphics
● Full function but 3-hour timeout limited. Download immediately.
v0.8
πŸ’Ύ (link)
v0.81
πŸ’Ύ (link)
πŸ“¦ RZ/G2L Mali Graphic Library (Unrestricted Version)
● Files to be added to the Yocto BSP to enable Graphics
● Due to license processing, requires 1 to 2 weeks before download.
v0.8
πŸ’Ύ (link)
v0.81
πŸ’Ύ (link)
(bottom of page)
πŸ“¦ RZ/G2L Video Codec Library
● Files to be added to the Yocto BSP to enable H.264 Video Encode/Decode
v0.53
πŸ’Ύ (link)
v0.55
πŸ’Ύ (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
v1.00
πŸ’Ύ (link)
v1.02
πŸ’Ύ (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.

Add HTML5 Browser to BSP v3.0.0

  • The following instructions will add Firefox and the HTML engine Gecko (version 91) to the VLP/G v3.0.0 BSP.
  • First, download and configure the BSP by following the Release Note document. Do the steps in Section 3, but stop at step "(6) Start a build". We need to make some changes before we run "bitbake core-image-weston".
  • Now that you have configured the BSP, you can follow the instructions below to add HTML support.
  • For the instructions below, start at the base of the BSP directory. If you are in the build directory, please do a cd .. first to get back to the base of the BSP before copy/pasting the instructions below.
  • Please note that these changes will break a core-image-qt build.
Instructions                              

Add meta layers to build Gecko91

$ git clone -b gem-firefox-91.0.0esr https://github.com/webdino/meta-browser.git
$ git clone https://github.com/meta-rust/meta-rust.git
$ git -C meta-rust checkout 1b59fd45906082c978d0a0a6e4e51a0ea4aa32c7
$ git -C meta-rust revert 647b976da2a9161ceb01ad477216480fc1c88af8 < /dev/null
$ git clone -b dunfell https://github.com/webdino/meta-clang.git

Add dummy files in meta-renesas/classes/ because the gecko recipes want to "inherit"

$ cd meta-renesas/classes
$ touch distutils.bbclass pythonnative.bbclass setuptools.bbclass
$ cd ../..

Edit the file build/conf/local.conf

$ gedit build/conf/local.conf &
  • Comment out the following line in the build/conf/local.conf by placing a "#" at the beginning of the line.
#DISTRO_FEATURES_remove = " x11"		
  • Add the following lines for Gecko91 at the end of build/conf/local.conf
IMAGE_INSTALL_append = " firefox "
IMAGE_INSTALL_append = " ttf-sazanami-gothic ttf-sazanami-mincho "
IMAGE_INSTALL_append = " pulseaudio-server "
IMAGE_INSTALL_append = " adwaita-icon-theme adwaita-icon-theme-cursors "
PACKAGECONFIG_append_pn-firefox = " openmax "
PACKAGECONFIG_append_pn-firefox = " webgl "
PACKAGECONFIG_append_pn-firefox = " gpu "
PREFERRED_VERSION_vte = "0.52.2"

TARGET_CXXFLAGS_remove_toolchain-clang = " --stdlib=libc++"
TUNE_CCARGS_remove_toolchain-clang = " --rtlib=compiler-rt --unwindlib=libunwind --stdlib=libc++"
TUNE_FEATURES_remove_toolchain-clang = "cortexa57-cortexa53"

DISTRO_FEATURES_append = " x11"
PACKAGECONFIG_remove = " libedit "

PACKAGECONFIG_remove_pn-xserver-xorg = " dri3 glamor "
IMAGE_INSTALL_remove = " matchbox-terminal "
  • Save and close local.conf


Edit the file build/conf/bblayers.conf

$ gedit build/conf/bblayers.conf &
  • Add the meta-layers (meta-rust, meta-clang, meta-browser) we downloaded (git cloned) to BBLAYERS
  ${TOPDIR}/../meta-rust \
  ${TOPDIR}/../meta-clang \
  ${TOPDIR}/../meta-browser \
  • Save and close bblayers.conf


Start the build

$ bitbake core-image-weston

How to launch Firefox91

  • After launching the board, you can launch Firefox91 with the following command.
  • We suggest that you use PMIC board with Full HD resolution(1920:1080) to evaluate HTML5.

Launch in a window:

$ WAYLAND_DISPLAY=wayland-0 GDK_BACKEND=wayland MOZ_OMX_RZG2L=1 firefox --width 640 --height 480

Launch full screen: (kiosk mode, adjust resolution to match your screen),

$ WAYLAND_DISPLAY=wayland-0 GDK_BACKEND=wayland MOZ_OMX_RZG2L=1 firefox --width 1024 --height 600 --kiosk https://renesas.info

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.

Changes to Github Break BSP Builds

The Issue:

  • Please be aware that changes to github.com effect older Yocto Recipes.
  • In summary, Yocto recipes that use git:// for the SRC URL will no longer work.
  • More details from Github can be found here.
  • Yocto has been updating the recipes to use https:// instead. For example, see this patch for Dunfell.

The Workaround

  • For building a BSP that contain recipes that still use git://, you use the command below.
  • Since this command uses --global, you only have to run it once on your PC.
$ git config --global url.https://github.com/.insteadOf git://github.com/

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