R-Car/Boards/M3NSK/Yocto-Gen3/v3.13.0

This page is out of date.
Please refer to the M3NSK-Yocto-Gen3 page for the latest version.

Introduction

This page contains information on building and running Yocto on:

• Renesas R-Car Starter Kit Pro(M3N) (unofficial name - M3NULCB),
• Infotainment Carrier Board For R-Car Starter Kit(Kingfisher)

Topic

SW Release Information

Board name	SW name	Release date	Note
R-Car Starter Kit ( Premier / Pro )	Yocto v4.1.0	2020/08/06	This version does not support MMP. GFX(except for Wayland/weston) is supported from 2020/09/23.
	Yocto v3.21.0	2019/07/09	New R-Car Starter Kit Pro(RTP8J77961ASKB0SK0SA05A) is supported from 2020/07/10.
Kingfisher Infotainment Board	Android P [New!!]	2020/09/29	Only R-Car Starter Kit Premier(R-Car H3) + Kingfisher is supported.
	Yocto v3.21.0	2019/08/07	To check for latest information, please refer to the meta-rcar. New R-Car Starter Kit Pro(RTP8J77961ASKB0SK0SA05A) is supported from 2020/08/02.
	Yocto v4.1.0	2020/10/23	This version does not support MMP.

[Note]:
The URL for downloading "Multimedia and Graphics library and related Linux drivers" has changed.
[OLD] https://www.renesas.com/us/en/solutions/automotive/rcar-download/rcar-demoboard.html
[NEW] https://www.renesas.com/us/en/application/automotive/r-car-h3-m3-h2-m2-e2-documents-software

Yocto versions

Poky-2.4.3 is supported with Yocto v3.13.0.
Specific commit of meta-openembedded is required.

Host PC

Ubuntu 16.04 LTS (64bit) is recommended as OS. 32bit version is not supported.

Preliminary steps

1. Please get the proprietary package for R-Car M3N from the your company's distributer.
2. Install required packages

   Ubuntu and Debian

   sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib \
        build-essential chrpath socat libsdl1.2-dev xterm python-crypto cpio python python3 \
        python3-pip python3-pexpect xz-utils debianutils iputils-ping libssl-dev
   

   Fedora

   sudo yum 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 \
        SDL-devel xterm python-crypto cpio python python3 python3-pip python3-pexpect \
        ghc-lzma-conduit iputils openssl
   

   Refer to Yocto Project Quick Start for more information.

Building the BSP for R-Car Starter Kit Pro(M3N)

Note: R-Car/Boards/Yocto-Gen3/v3.13.0#Known_issues_and_limitations(No.3).

Build using script

1. Directory Structure

   |--build.sh
   `--proprietary
      `-- <Proprietary package for R-Car M3N>
   

2. Build script(build.sh)

   #!/bin/bash
   
   TARGET_BOARD=m3nulcb
   
   # Create a directory and switch to it
   mkdir ${TARGET_BOARD}
   cd ${TARGET_BOARD}
   WORK=`pwd`
   
   # Clone basic Yocto layers in parallel
   git clone git://git.yoctoproject.org/poky &
   git clone git://git.linaro.org/openembedded/meta-linaro.git &
   git clone git://git.openembedded.org/meta-openembedded &
   git clone git://github.com/renesas-rcar/meta-renesas &
   git clone git://github.com/CogentEmbedded/meta-rcar.git &
   
   # Wait for all clone operations
   wait
   
   # Switch to proper branches/commits
   cd $WORK/poky
   git checkout -b tmp 7e7ee662f5dea4d090293045f7498093322802cc
   cd $WORK/meta-openembedded
   git checkout -b tmp 352531015014d1957d6444d114f4451e241c4d23
   cd $WORK/meta-linaro
   git checkout -b tmp 75dfb67bbb14a70cd47afda9726e2e1c76731885
   cd $WORK/meta-renesas
   git checkout -b tmp 00f70f062aace04c051fa92d3cd7b887718fc313
   cd $WORK/meta-rcar
   git checkout -b v3.13.0 remotes/origin/v3.13.0
   
   # Populate meta-renesas with proprietary software packages
   cd $WORK/meta-renesas
   sh meta-rcar-gen3/docs/sample/copyscript/copy_proprietary_softwares.sh -f $WORK/../proprietary
   
   cd $WORK
   source poky/oe-init-build-env $WORK/build
   
   #cp $WORK/meta-rcar/meta-rcar-gen3-adas/docs/sample/conf/${TARGET_BOARD}/poky-gcc/bsp/*.conf ./conf/.
   #cp $WORK/meta-rcar/meta-rcar-gen3-adas/docs/sample/conf/${TARGET_BOARD}/poky-gcc/gfx-only/*.conf ./conf/.
   cp $WORK/meta-rcar/meta-rcar-gen3-adas/docs/sample/conf/${TARGET_BOARD}/poky-gcc/mmp/*.conf ./conf/
   
   cd $WORK/build
   cp conf/local-wayland.conf conf/local.conf
   
   bitbake-layers add-layer ../meta-rcar/meta-rcar-gen3-adas
   
   bitbake core-image-weston
   

3. build

   ./build.sh
   

   If the build completes successfully, all the necessary files are generated in a following directory:

   ./<target_board_name>/build/tmp/deploy/images/<target_board_name>
   

Build using manual steps

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.

   mkdir build
   cd build
   export WORK=`pwd`
   

2. Clone 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
   git clone git://github.com/renesas-rcar/meta-renesas
   git clone git://github.com/CogentEmbedded/meta-rcar.git
   

3. Switch to proper branches/commits

   cd $WORK/poky
   git checkout -b tmp 7e7ee662f5dea4d090293045f7498093322802cc
   cd $WORK/meta-openembedded
   git checkout -b tmp 352531015014d1957d6444d114f4451e241c4d23
   cd $WORK/meta-linaro
   git checkout -b tmp 75dfb67bbb14a70cd47afda9726e2e1c76731885
   cd $WORK/meta-renesas
   git checkout -b tmp 00f70f062aace04c051fa92d3cd7b887718fc313
   cd $WORK/meta-rcar
   git checkout -b v3.13.0 remotes/origin/v3.13.0
   

   Another versions are not tested for compatibility.

   Legacy BSP instruction can be found here R-Car M3NSK Yocto Gen3 legacy

4. Please get the proprietary package for R-Car M3N from the your company's distributer. And copy them to $WORK/proprietary folder.
5. Populate meta-renesas with proprietary software packages.

   export PKGS_DIR=$WORK/proprietary
   cd $WORK/meta-renesas
   sh meta-rcar-gen3/docs/sample/copyscript/copy_proprietary_softwares.sh -f $PKGS_DIR
   unset PKGS_DIR
   

6. Setup build environment

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

7. Prepare default configuration files.

   cp $WORK/meta-rcar/meta-rcar-gen3-adas/docs/sample/conf/m3nulcb/poky-gcc/mmp/*.conf ./conf/
   cd $WORK/build
   cp conf/local-wayland.conf conf/local.conf
   

8. Add layer meta-rcar.

   bitbake-layers add-layer ../meta-rcar/meta-rcar-gen3-adas
   

9. Start the build

   bitbake core-image-weston
   

Build SDK

Refer to R-Car/Boards/Yocto-Gen3#Build_SDK.

Running Yocto images

Refer to follows:

• R-Car/Boards/Yocto-Gen3#Running_Yocto_images.
• R-Car/Boards/M3NSK#Booting_Linux

Q&A site

http://renesasrulz.com/r-car-h3-m3-cockpit/

FAQ page

https://elinux.org/R-Car/Boards/Yocto-Gen3-CommonFAQ