Skip to end of metadata
Go to start of metadata

This page describes building Genivi 14 (Pulsar) platforms for Yocto Project 2.5 (Sumo) using Renesas R-Car SoC BSPs.

Specifically the page was written for the R-Car Generation 3 SoCs: H3, M3, M3N and E3

General (read first)

This section provides information that applies to all platforms. Information for specific platforms, such as the Genivi Yocto Baseline (meta-ivi) and GDP, is covered in the following section. Please read this section first.

Yocto BSP Compatibility

The standard Renesas customer Yocto BSP meets the functional and version requirements of Genivi 14 compliance. The kernel simply needs to be configured for the requirements of the Genivi 14 platform.

At a minimum the following kernel config options are enabled:

  • FHANDLE
  • EXPERIMENTAL
  • ECRYPT_FS
  • QUOTA
  • BT
  • CGROUPS


The Genivi 14 specification does not specify a build system and instead allows the implementer the freedom to choose what fits their needs best. The Genivi implementations of the specification in the shape of the Genivi Yocto Baseline (meta-ivi v14.5x) and Genivi Development Platform (GDP v14.1.x) released in the second half of 2018 both use Yocto Project 2.5 (Sumo).

At the time of writing Renesas provide Yocto Project 2.5 support in the R-Car Community Yocto BSP. Then as a service to the community Renesas maintains the Yocto layer meta-ivi-renesas which adapts the Yocto BSP to the needs of the Genivi Yocto Baseline. The combination of the two layers can then be used to build Genivi 14 software for Yocto Project 2.5. Renesas works in the Genivi Baseline Integration Team (BIT) and Genivi Development Platform (GDP) to ensure that the combination can be used to build those images for example.

Here are the details:

PurposeRepository locationBranch
Upstream Yocto BSP supporthttps://github.com/renesas-rcar/meta-renesas.gitsumo-dev

Adapt Yocto BSP (meta-renesas) to Genivi Yocto Baseline (meta-ivi)

https://github.com/GENIVI/meta-ivi-renesas.gitgenivi-14.x-sumo

Specific Genivi Platforms

This section provides information for specific Genivi platforms such as the Genivi Baseline and GDP.

Genivi Development Platform (GDP)

Instructions for building and deploying GDP on the R-Car H3/M3 Starter Kit and H3/M3 Salvator-X(S) boards are maintained in the GDP wiki pages. The current working branch can be found in the 14.1.x-sumo branch of GDP.

Instructions for building and deploying GDP on the R-Car H3/M3 Starter Kit and H/3M3 Salvator-X boards are maintained in the GDP Master wiki page. 

Issues are maintained in the Genivi JIRA GDP project.

Genivi Yocto Baseline (GYB)

For those familiar with Yocto and the GYB you can find the Pulsar Renesas Yocto BSP details for Gen 3 in the table below. At the time of writing they have been successfully tested with meta-ivi 14.50.1 (Pulsar + Sumo).

Steps:

1) Clone and checkout Genivi Yocto Baseline repositories

See the meta-ivi Readme.md for details.

2) Clone and checkout the Renesas required layers.

Note: With YP 2.4 meta-renesas switched from the linaro gcc toolchain to using the poky gcc toolchain by default. You therefore no longer need to use the meta-linaro-toolchain layers.

3) Obtain and install the Renesas R-Car Graphics and Multimedia packages

4) You can now follow the build instructions in the meta-ivi Readme.md.

4a) Export TEMPLATECONF to pick up correct configuration for the build

export TEMPLATECONF=/full/path/to/meta-ivi/meta-ivi/conf

4b) Run the following command:

> $ source poky/oe-init-build-env 

BBLAYERS += " \

  ${TOPDIR}/../meta-renesas/meta-rcar-gen3 \

  ${TOPDIR}/../meta-openembedded/meta-oe \

      ${TOPDIR}/../meta-openembedded/meta-filesystems \
      ${TOPDIR}/../meta-linaro/meta-optee \
      ${TOPDIR}/../meta-ivi-renesas \
   "

M3 Starter Kit
Local.conflink

At the time of writing meta-ivi does not add the weston-init package required to start weston using systemd to the rootfs by default. If you would like to run gfx applications, such as the wayland ivi-extension mock navigation application, please add the following line to your local.conf so weston-init is added:

    IMAGE_INSTALL_append = " weston-init"

To add the R-Car gfx and mmp packages to the image please add the following line to your local.conf:

# Add R-Car Gfx and MMP packages to install
IMAGE_INSTALL_append_rcar-gen3 = " \
    packagegroup-gstreamer1.0-plugins \
    packagegroup-wayland-community \
    packagegroup-graphics-renesas-proprietary \
    packagegroup-graphics-renesas-wayland \
"

4d) Build the baseline including the Genivi components

> $ bitbake pulsar-image