OpenEmbedded/Yocto BSP layer for Renesas Electronics's SoCs

This layer provides support for Renesas Electronics's platforms for use with OpenEmbedded and/or Yocto.

Layer maintainer(s):

Please see the MAINTAINERS file for more details.

Supported Boards/Machines

In addition, this also provides layer which supports boards using Renesas SoCs. Layers and boards that support is the following:

- Renesas Electronics Corporation. R-Car Salvator-X (H3: R8A77950/R8A77951, M3: R8A77960/R8A77961, M3N: R8A77965)
- Renesas Electronics Corporation. R-Car Starter Kit premier(H3ULCB) (R8A77951)
- Renesas Electronics Corporation. R-Car Starter Kit pro(M3ULCB) (R8A77960/R8A77961)
- Renesas Electronics Corporation. R-Car Starter Kit pro(M3NULCB) (R8A77965)
- Renesas Electronics Corporation. R-Car Ebisu (R8A77990)
- Renesas Electronics Corporation. R-Car Draak (R8A77995)
- Renesas Electronics Corporation. R-Car S4 Starter Kit (R8A779F0)
- Renesas Electronics Corporation. R-Car Spider (R8A779F0)

Original BSP image

core-image-minimal

Contribution

Please submit any patches for this layer to: rcar-yocto@lm.renesas.com
Please see the MAINTAINERS file for more details.

Layer Dependencies

This layer depends on:

poky

    URI: git://git.yoctoproject.org/poky
    layers: meta, meta-poky, meta-yocto-bsp
    branch: scarthgap

meta-openembedded

    URI: git://git.openembedded.org/meta-openembedded
    layers: meta-oe, meta-python, meta-networking
    branch: scarthgap

Build Instructions

Required Environment

Refer to https://docs.yoctoproject.org/brief-yoctoprojectqs/index.html to prepare Build Host.
This also needs git user name and email defined:

   $ git config --global user.email "you@example.com"
   $ git config --global user.name "Your Name"

Then, using one of three way to build Image. (Manual Build, Using template configuration, Using Renesas'script)

Manual Build

Create a directory as working folder

    $ mkdir build
    $ cd build
    $ export WORK=`pwd`

Clone required layers

    $ cd $WORK
    $ git clone git://git.yoctoproject.org/poky
    $ git clone git://git.openembedded.org/meta-openembedded
    $ git clone https://rcar-env.dgn.renesas.com/gitlab/linuxbsp_yocto/meta-renesas-upstream-bsp.git

Switch to proper branches/commits

    $ cd $WORK
    $ git -C poky checkout -b scarthgap origin/scarthgap
    $ git -C meta-openembedded checkout -b scarthgap origin/scarthgap
    $ git -C meta-renesas-upstream-bsp checkout -b scarthgap origin/scarthgap

Initialize a build using the 'oe-init-build-env' script in Poky. e.g.:

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

After that, initialized configure bblayers.conf by adding meta-rcar-gen3 layer. e.g.:

    BBLAYERS ?= " \
        <path to layer>/poky/meta \
        <path to layer>/poky/meta-poky \
        <path to layer>/poky/meta-yocto-bsp \
        <path to layer>/meta-renesas-upstream-bsp \
        <path to layer>/meta-openembedded/meta-oe \
        <path to layer>/meta-openembedded/meta-python \
        <path to layer>/meta-openembedded/meta-networking \
    "

To build a specific target BSP, configure the associated machine in local.conf:

    MACHINE ??= "<supported board name>"

Board	MACHINE
Salvator-X/XS	MACHINE = "salvator-x"
Ebisu	MACHINE = "ebisu"
Starter Kit Pro (M3ULCB)	MACHINE = "m3ulcb"
Starter Kit Pro (M3NULCB)	MACHINE = "m3nulcb"
Starter Kit Premier (H3ULCB)	MACHINE = "h3ulcb"
Draak	MACHINE = "draak"
S4 Starter Kit	MACHINE = "s4sk"
S4 Spider	MACHINE = "spider"

Select the SOC

For H3: r8a7795

    SOC_FAMILY = "r8a7795"

For M3: r8a7796

    SOC_FAMILY = "r8a7796"

For M3N: r8a77965

    SOC_FAMILY = "r8a77965"

For E3: r8a77990

    # Already added in machine config: ebisu.conf
    SOC_FAMILY = "r8a77990"

For D3: r8a77995

    # Already added in machine config: draak.conf
    SOC_FAMILY = "r8a77995"

For s4 Starter Kit: r8a779f0

    # Already added in machine config: s4sk.conf
    SOC_FAMILY = "r8a779f0"

For Spider: r8a779f0

    # Already added in machine config: spider.conf
    SOC_FAMILY = "r8a779f0"

Configure for systemd init in local.conf:

    DISTRO_FEATURES:append = " usrmerge systemd"
    VIRTUAL-RUNTIME_init_manager = "systemd"

Configure for ivi-shell and ivi-extension

    DISTRO_FEATURES:append = " ivi-shell"

Configure for USB 3.0

    MACHINE_FEATURES:append = " usb3"

Enable tuning support for Capacity Aware migration Strategy (CAS)

    MACHINE_FEATURES:append = " cas"

For a list of sample local.conf file, please refer to: conf/templates/
Build the target file system image using bitbake:

    $ bitbake core-image-minimal

After completing the images for the target machine will be available in the output directory 'tmp/deploy/images/'.

Images generated:

Image (generic Linux Kernel binary image file)
<SoC>-<machine name>.dtb (DTB for target machine)
core-image-minimal-<machine name>.tar.bz2 (rootfs tar+bzip2)
core-image-minimal-<machine name>.ext4 (rootfs ext4 format)

Using template configuration

Create a directory as working folder

    $ mkdir build
    $ cd build
    $ export WORK=`pwd`

Clone required layers

    $ cd $WORK
    $ git clone git://git.yoctoproject.org/poky
    $ git clone git://git.openembedded.org/meta-openembedded
    $ git clone https://rcar-env.dgn.renesas.com/gitlab/linuxbsp_yocto/meta-renesas-upstream-bsp.git

Switch to proper branches/commits

    $ cd $WORK
    $ git -C poky checkout -b scarthgap origin/scarthgap
    $ git -C meta-openembedded checkout -b scarthgap origin/scarthgap
    $ git -C meta-renesas-upstream-bsp checkout -b scarthgap origin/scarthgap

Initialize a build using the 'oe-init-build-env' script in Poky. e.g.:

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

Copy sample configuration to build folder. e.g.:

    $ cp ../meta-renesas-upstream-bsp/conf/templates/<board/machine>/local.conf.sample conf/local.conf
    $ cp ../meta-renesas-upstream-bsp/conf/templates/<board/machine>/bblayers.conf.sample conf/bblayers.conf

<board/machine>: h3ulcb, m3ulcb, m3nulcb, salvator-x, ebisu, draak, s4sk, spider
With Salvator-x, edit SOC_FAMILY into "conf/local.conf"
- For H3: r8a7795
```
    SOC_FAMILY = "r8a7795"
```
- For M3: r8a7796
```
    SOC_FAMILY = "r8a7796"
```
- For M3N: r8a77965
```
    SOC_FAMILY = "r8a77965"
```

Example:

    $ cp ../meta-renesas-upstream-bsp/conf/templates/h3ulcb/local.conf.sample conf/local.conf
    $ cp ../meta-renesas-upstream-bsp/conf/templates/h3ulcb/bblayers.conf.sample conf/bblayers.conf

Build the target file system image using bitbake:

    $ bitbake core-image-minimal

Using Renesas'script

Create a directory as working folder

    $ mkdir build
    $ cd build
    $ export WORK=`pwd`

Clone required layers

    $ cd $WORK
    $ git clone git://git.yoctoproject.org/poky
    $ git clone git://git.openembedded.org/meta-openembedded
    $ git clone https://rcar-env.dgn.renesas.com/gitlab/linuxbsp_yocto/meta-renesas-upstream-bsp.git

Switch to proper branches/commits

    $ cd $WORK
    $ git -C poky checkout -b scarthgap origin/scarthgap
    $ git -C meta-openembedded checkout -b scarthgap origin/scarthgap
    $ git -C meta-renesas-upstream-bsp checkout -b scarthgap origin/scarthgap

Run Renesas'script to build

    $ cd $WORK
    $ source meta-renesas-upstream-bsp/init-env-and-build <board/machine> <kernel_version> <builddir>

<board/machine>: h3ulcb, m3ulcb, m3nulcb, h3, m3, m3n, ebisu, draak, s4sk, spider
<kernel_version>: 6.1, 6.6

Example:

    $ source meta-renesas-upstream-bsp/init-env-and-build m3n 6.1 build_m3n_kernel_6.1

Build Instructions for SDK

NOTE:

This may be changed in the near feature. These instructions are tentative.

Should define the staticdev in SDK image feature for installing the static libs to SDK in local.conf.

    SDKIMAGE_FEATURES:append = " staticdev-pkgs"

For 64-bit target SDK (aarch64)

Use bitbake -c populate_sdk for generating the toolchain SDK

    $ bitbake core-image-minimal -c populate_sdk

The SDK can be found in the output directory tmp/deploy/sdk

poky-glibc-x86_64-core-image-minimal-aarch64-<machine name>-toolchain-x.x.sh

Usage of toolchain SDK

Install the SDK to the default: /opt/poky/x.x

For 64-bit target SDK

    $ sh poky-glibc-x86_64-core-image-minimal-aarch64-<machine name>-toolchain-x.x.sh

For 64-bit application, using environment script in /opt/poky/x.x

    $ source /opt/poky/x.x/environment-setup-aarch64-poky-linux

R-Car Information

Refer to the following for more information from eLinux website

https://elinux.org/R-Car

Name		Name	Last commit message	Last commit date
Latest commit History 17 Commits
conf		conf
include		include
recipes-bsp		recipes-bsp
recipes-core		recipes-core
recipes-kernel		recipes-kernel
wic		wic
LICENSE		LICENSE
MAINTAINERS		MAINTAINERS
README.md		README.md
init-env-and-build		init-env-and-build

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

OpenEmbedded/Yocto BSP layer for Renesas Electronics's SoCs

Supported Boards/Machines

Original BSP image

Contribution

Layer Dependencies

Build Instructions

Required Environment

Manual Build

Using template configuration

Using Renesas'script

Build Instructions for SDK

For 64-bit target SDK (aarch64)

Usage of toolchain SDK

R-Car Information

About

Releases

Packages

Contributors 2

Languages

License

renesas-rcar/meta-renesas-upstream-bsp

Folders and files

Latest commit

History

Repository files navigation

OpenEmbedded/Yocto BSP layer for Renesas Electronics's SoCs

Supported Boards/Machines

Original BSP image

Contribution

Layer Dependencies

Build Instructions

Required Environment

Manual Build

Using template configuration

Using Renesas'script

Build Instructions for SDK

For 64-bit target SDK (aarch64)

Usage of toolchain SDK

R-Car Information

About

Resources

License

Stars

Watchers

Forks

Releases

Packages 0

Contributors 2

Languages

Packages