RZ-G/Boards/Yocto 2.0

This page contains information on building and running Yocto 2.0 on the Renesas RZ/G1E and Renesas RZ/G1M Starter Kit boards.

Supported Linux distributions

Yocto 2.0 (Jethro) is compatible with various Linux distributions - Ubuntu 14 and 15, Debian 7 and 8, Fedora 21 and 21 and others. For a complete list of the supported distributions see the Supported Linux Distributions section of the Yocto 2.0 Reference Manual. Please use one of the distributions on that list, e.g. Ubuntu 14.04 LTS.

Preliminary steps

1. Download proprietary graphics and multimedia libraries and drivers from Renesas. Evaluation version of the libraries is available at
   https://www.renesas.com/en-hq/software/D6000548.html
   and the related drivers can be downloaded from
   https://www.renesas.com/en-hq/software/D6000544.html
   The Graphic packages are required for X11 and Wayland. Multimedia drivers are optional.
   
   
2. Install required packages:
   Ubuntu and Debian

   sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib \
        build-essential chrpath socat
   

   Fedora

   sudo dnf install gawk make wget tar bzip2 gzip python unzip perl patch \
        diffutils diffstat git cpp gcc gcc-c++ glibc-devel texinfo chrpath \
        ccache perl-Data-Dumper perl-Text-ParseWords perl-Thread-Queue socat \
        findutils which
   

   Refer to Yocto Project Quick Start for more information.

Building the BSP for the Renesas RZ/G1 Starter Kit Boards

1. Create a directory and switch to it
   Warning! Yocto builds require a lot of disk space (up to 100 GB). Make sure you have got enough before starting the build.

   export WORK=<path-to-your-build-directory>
   mkdir $WORK
   cd $WORK
   

2. Clone the basic Yocto layers:

   cd $WORK
   git clone git://git.yoctoproject.org/poky
   git clone git://git.openembedded.org/meta-openembedded
   git clone git://git.linaro.org/openembedded/meta-linaro.git
   

3. Switch to proper branches/commits:

   cd $WORK/poky
   git checkout -b tmp 3b223f75eec1738fbc913858e8e11c8305e3edcb
   
   cd $WORK/meta-openembedded
   git checkout -b tmp dc5634968b270dde250690609f0015f881db81f2
   
   cd $WORK/meta-linaro
   git checkout -b tmp 12993e6bc8658ee37d303d8d59007f8dd9ab2b30
   

   Other versions are not tested for compatibility.

4. Clone the Renesas BSP layer:

   cd $WORK
   git clone https://github.com/renesas-rz/meta-renesas
   

5. Switch to the yocto_2.0 branch:

   cd $WORK/meta-renesas
   git checkout yocto_2.0
   

6. Download the proprietary libraries from
   https://www.renesas.com/en-hq/software/D6000548.html
   and related kernel drivers from https://www.renesas.com/en-hq/software/D6000544.html
7. Create an install folder for the proprietary libraries:

   cd $WORK
   mkdir proprietary
   

   Copy the downloaded proprietary libraries into this new folder, e.g.:

   cp ~/Downloads/RZG_Series_Evaluation_Software_Package* $WORK/proprietary
   

8. Unzip the proprietary libraries, e.g.:

   cd $WORK/proprietary
   unzip RZG_Series_Evaluation_Software_Package_for_Linux-20161011.tar.gz.zip
   unzip RZG_Series_Evaluation_Software_Package_of_Linux_Drivers-20161011.tar.gz.zip
   

   You should see the following files:

   $ ls -l $WORK/proprietary
   total 4.3M
   -rw-rw-r-- 1 builduser builduser 3.1M Dec 06 10:25 RZG_Series_Evaluation_Software_Package_for_Linux-20101011.tar.gz
   -rw-rw-r-- 1 builduser builduser 1.2M Dec 06 10:25 RZG_Series_Evaluation_Software_Package_of_Linux_Drivers-20161011.tar.gz
   

9. Populate the meta-renesas layer with graphics and multimedia drivers:

   cd $WORK/meta-renesas/meta-rzg1
   ./copy_gfx_software_<board>.sh ../../proprietary
   ./copy_mm_software_lcb.sh ../../proprietary
   

10. Setup build environment:

    cd $WORK
    source poky/oe-init-build-env
    

11. Prepare default configuration files:

    cd $WORK/build
    cp ../meta-renesas/meta-rzg1/templates/<board>/bblayers.conf ./conf
    

    For weston/wayland:

    cp ../meta-renesas/meta-rzg1/templates/<board>/local-wayland.conf ./conf/local.conf
    

    For X11:

    cp ../meta-renesas/meta-rzg1/templates/<board>/local-x11.conf ./conf/local.conf
    

    Edit local.conf to enable/disable graphics and multimedia proprietary drivers support. The H264 encoder library is not enabled by default, in order to enable it uncomment the following line:
    DISTRO_FEATURES_append = " h264avcenc_lib"

12. Start the build
    For weston/wayland:

    bitbake core-image-weston
    

    For X11:

    bitbake core-image-x11
    

    Building the image can take up to a few hours depending on your host system performance.
    After the build has been completed successfully, you should see the output similar to:

    NOTE: Tasks Summary: Attempted 4704 tasks of which 31 didn't need to be rerun and all succeeded.
    

    and the command prompt should return.

13. Bitbake has generated all the necessary files in ./tmp/deploy/images directory.
    uImage is the kernel image, uImage-r8a7745-skrzg1e.dtb is the device tree file, uImage+dtb is the combined kernel and device tree image, core-image-weston-skrzg1e.tar.bz2 is the rootfs, modules-skrzg1e.tgz are the kernel modules.
14. You can now boot the RZ/G1E or RZ/G1M Starter Kit boards over TFTP and NFS