How To Build Linux BSP Plus for RZ/T,N¶

Introduction¶

This page explains how to build Linux BSP Plus source code.

Step 1: Build Renesas RZ Linux BSP Plus source code¶

This step explains how to build Linux environment with Renesas RZ Linux BSP Plus source code.

1. Install the required packages

   Install some packages into your Linux PC, which are necessary in the following steps.

   sudo apt-get update
   sudo apt install build-essential chrpath cpio debianutils diffstat file gawk gcc git iputils-ping libacl1 liblz4-tool locales python3 python3-git python3-jinja2 python3-pexpect python3-pip python3-subunit socat texinfo unzip wget xz-utils zstd bmap-tools
   pip3 install --user kas
   

2. Set up your git environment

   Set up your git environment if you have never done it.

   git config --global user.email "<Your email address>"
   git config --global user.name "<Your user name>"
   

   Note

   For more information, refer to Yocto Project Quick Build.

3. Set environment variables

   Set the following environment variables.

   RZ/T2HRZ/N2H

   export WORK=<A directory path for building>
   export BOARD=rzt2h-dev
   

   export WORK=<A directory path for building>
   export BOARD=rzn2h-dev
   

4. Clone Yocto recipe package

   Create a working directory, and clone Yocto recipe package.

   mkdir ${WORK}
   cd ${WORK}
   

   git clone https://github.com/renesas-rz/meta-renesas
   cd meta-renesas
   git checkout -b tmp BSP-PLUS-K6.12-V3.0
   cd ../
   kas checkout meta-renesas/kas/base.yml
   

5. Initialize build environment

   Run an environment setup script as follows.

   cd ${WORK}
   TEMPLATECONF=${PWD}/meta-renesas/meta-rz-distro/conf/templates/vlp-v5-conf/ source poky/oe-init-build-env build
   

6. Install ethtool command

   "ethtool" command is a command for configuring network interfaces. If you want to install the ethtool command on Linux, modify local.conf by the following instruction.

   Yocto 5.0 (Scarthgap)

   cd ${WORK}/build
   echo 'IMAGE_INSTALL:append = " ethtool"' >> conf/local.conf
   

7. Build images

   Run bitbake command to build images.

   RZ/T2HRZ/N2H

   cd ${WORK}/build
   MACHINE=${BOARD} bitbake core-image-minimal
   

   Note

   After building images, you can find them in the following directories.

   • Images: ${WORK}/build/tmp/deploy/images/${BOARD}/

   Device	Category	File name
   RZ/T2H	Linux kernel	Image-rzt2h-dev.bin
   	Device tree file	r9a09g077m44-dev.dtb
   	Root filesystem	core-image-minimal-rzt2h-dev.rootfs.tar.bz2
   	Boot loader	bl2_bp_esd-rzt2h-dev.bin bl2_bp_emmc-rzt2h-dev.srec bl2_bp_xspi0-rzt2h-dev.srec fip-rzt2h-dev.srec
   	Flash Writer	HDR_NM Flash_Programmer_SCIF_CR52_RZT2H_EVK.mot
   	SD image (wic)	core-image-minimal-rzt2h-dev.rootfs.wic.gz core-image-minimal-rzt2h-dev.rootfs.wic.bmap

   Note

   If you need to create an SDK toolchain, run bitbake command as follows.

   cd ${WORK}/build
   MACHINE=${BOARD} bitbake core-image-minimal -c populate_sdk
   

   After building SDK toolchain, you can find them in the following directory.

   ${WORK}/build/tmp/deploy/sdk/
   

   cd ${WORK}/build
   MACHINE=${BOARD} bitbake core-image-minimal
   

   Note

   After building images, you can find them in the following directories.

   • Images: ${WORK}/build/tmp/deploy/images/${BOARD}/

   Device	Category	File name
   RZ/N2H	Linux kernel	Image-rzn2h-dev.bin
   	Device tree file	r9a09g087m44-dev.dtb
   	Root filesystem	core-image-minimal-rzn2h-dev.rootfs.tar.bz2
   	Boot loader	bl2_bp_esd-rzn2h-dev.bin bl2_bp_emmc-rzn2h-dev.srec bl2_bp_xspi0-rzn2h-dev.srec fip-rzn2h-dev.srec
   	Flash Writer	HDR_NM Flash_Programmer_SCIF_CR52_RZT2H_EVK.mot
   	SD image (wic)	core-image-minimal-rzn2h-dev.rootfs.wic.gz core-image-minimal-rzn2h-dev.rootfs.wic.bmap

   Note

   If you need to create an SDK toolchain, run bitbake command as follows.

   cd ${WORK}/build
   MACHINE=${BOARD} bitbake core-image-minimal -c populate_sdk
   

   After building SDK toolchain, you can find them in the following directory.

   ${WORK}/build/tmp/deploy/sdk/
   

Step 2: Additional Feature Packages (optional)¶

There are some additional feature packages for RZ Linux BSP Plus as follows.

Please obtain the necessary files from the following links according to the features you wish to add. For instructions on how to integrate the packages, refer to the documentation included in the downloaded files or, in the case of Git, the README.