Early Access Fixes for VLP¶

Renesas actively provides fixes, security updates, and maintenance patches through the official GitHub repository for the RZ Family Yocto build layer¹ included in the Verified Linux Package (VLP).

For details of applicable fixes and advisories, refer to the table in the Affected VLP Releases section below.

Affected VLP Releases¶

How to Apply a Patch to the Renesas Yocto Build Layer¶

To apply a fix from the Renesas Yocto build layer:

• Replace your existing meta-renesas layer with the updated version (see here).
• Backport the relevant commit referenced in the Affected VLP Releases table (see here).

Replacing the Renesas Yocto Build Layer¶

1. Navigate to your work directory

   cd ${WORK}
   

2. Remove the existing meta-renesas layer

   rm -rf ${WORK}/meta-renesas
   

   Caution

   This command permanently removes the existing meta-renesas layer from your work directory.

   Ensure that any required changes are backed up before proceeding. Users are responsible for verifying the impact of this operation on their development environment.

3. Clone the VLP Yocto build layer (meta-renesas)

   git clone https://github.com/renesas-rz/meta-renesas.git --branch <reference branch name>
   

   Note

   <reference branch name> refers to the repository branch specified in the note for the corresponding entry in the Affected VLP Releases.

4. Navigate to the cloned meta-renesas repository

   cd ${WORK}/meta-renesas
   

5. Check out the commit associated with the required VLP fix

   git checkout -b tmp-$(date +%Y%m%d%H%M%S) <commit id>
   

   Caution

   Refer to the Commit ID column in the Affected VLP Releases table to obtain the <commit id>.

6. Navigate to your work directory

   cd ${WORK}
   

7. Initialize build environment

   Yocto 5.0 (Scarthgap)Yocto 3.1 (Dunfell)

   TEMPLATECONF=${PWD}/meta-renesas/meta-rz-distro/conf/templates/rz-bsp-plus-conf/ source poky/oe-init-build-env build
   

   TEMPLATECONF=${PWD}/meta-renesas/meta-${PLATFORM}/docs/template/conf/ source poky/oe-init-build-env build
   

8. Build

   MACHINE=${BOARD} bitbake <image name>
   

   Note

   Depending on your environment and VLP configuration, one or more of the following image targets (<image name>) may be available:

   • core-image-minimal
   • core-image-weston
   • core-image-qt

Backporting a Specific Commit from the Renesas Yocto Build Layer¶

Get the Patch¶

To backport a specific fix, obtain the patch using one of the following methods:

1. Download the patch directly from the Affected VLP Releases table.

2. Clone the meta-renesas repository into a temporary work directory and generate the patch locally.

   1. Navigate to your temporary work directory

      cd ${TEMP_WORK}
      

   2. Clone the VLP Yocto build layer (meta-renesas)

      git clone https://github.com/renesas-rz/meta-renesas.git --branch <reference branch name>
      

      Note

      <reference branch name> refers to the repository branch specified in the note for the corresponding entry in the Affected VLP Releases.

   3. Navigate to the cloned meta-renesas repository

      cd ${TEMP_WORK}/meta-renesas
      

   4. Check out the commit associated with the required fix

      git checkout -b tmp-$(date +%Y%m%d%H%M%S) <commit id>
      

      Caution

      Refer to the Commit ID column in the Affected VLP Releases table to obtain the <commit id>.

   5. Generate the patch file

      git format-patch -1
      

   After generating or downloading the patch, apply it to your local source tree and rebuild the affected components.

   Caution

   Any merge conflicts encountered during patch application must be reviewed and resolved before proceeding with the build.

Applying a Patch¶

To apply patch, please navigate to the meta-renesas repository in your work directory:

cd ${WORK}/meta-renesas

Apply the patch using git am:

git am <patch file>