RZ-G/RZ-G2 BSP: Difference between revisions
(remove old verions) Β |
|||
(55 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
{{DISPLAYTITLE:RZ/G2 BSP Information Page}} | {{DISPLAYTITLE:RZ/G2 and RZ/V2 BSP Information Page}} | ||
Β | |||
= Overview = | |||
[[File:VLP Diagram.png|right|500px|VLP Diagram]] | |||
* The Renesas BSPs for MPUs are distributed as '''Yocto''' builds. | |||
* Renesas specific portions (boot loader, kernel, etc..) are store in [https://github.com/renesas-rz github] which is where the Yocto recipes pull from. | |||
* Additional Yocto patch files are included in the renesas.com download packages that you will '''not''' find on github. | |||
* Some libraries (graphics and video codecs) are '''proprietary''' can only be downloaded from renesas.com after registering. | |||
* For the structure of the BSPs, there are a common Yocto layers that are used to build most Renesas software for each MPU. However, additional 'optional' software components are distributed and downloaded as "Features". There is a '''meta-rz-features''' Yocto layer directory where individual Yocto recipes can be added to a build if needed. | |||
* The '''diagram on the above''' shows the common Yocto build in blue, and the optional Feature Packages that can be added. (Click for full size) | |||
<br> | |||
[[File:VLP support version overview.png|right|500px]] | |||
* The Linux kernel is based off the [https://www.cip-project.org Civil Infrastructure Platform (CIP)] which is based off the official stable kernel trees. | |||
* The CIP project aims to backport bug fixes and security patches for 10 years. | |||
* The '''diagram on the right''' shows the timeline for the kernel versions used in the Renesas BSPs. | |||
<br> | |||
<br> | |||
<br> | |||
<br> | |||
<br> | |||
<br> | |||
= Downloads = | = Downloads = | ||
==Linux 5.10 BSP | == Linux Kernel 5.10 BSP == | ||
* <font size=+2>'''RZ/G2L, RZ/G2LC, RZ/G2UL, RZ/G2E, RZ/G2N, RZ/G2M, RZ/G2H'''</font> | * <font size=+2>'''RZ/G2 Series: <font color=blue>RZ/G2L, RZ/G2LC, RZ/G2UL,</font> <font color=green>RZ/G2E, RZ/G2N, RZ/G2M, RZ/G2H</font>'''</font> | ||
* <font size=+2>'''RZ/V2 Series: <font color=orange>RZ/V2L</font>'''</font> | |||
* <font size=+1>Verified Linux Package [5.10-CIP] Version 3.0.x</font> | |||
* <font size=+1> β [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-mpus/rzg-linux-platform/rzg-marketplace/verified-linux-package/rzg-verified-linux-package Official RZ/G2 BSP Download Page] </font> | * <font size=+1> β [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-mpus/rzg-linux-platform/rzg-marketplace/verified-linux-package/rzg-verified-linux-package Official RZ/G2 BSP Download Page] </font> | ||
* <font size=+1> β [https://www.renesas.com/jp/en/software-tool/rzv-verified-linux-package-510-cip Official RZ/V2 BSP Download Page] </font> | |||
* Please Download the individual components required for your MPU. | * Please Download the individual components required for your MPU. | ||
* Please use the package versions listed table | * Please use the package '''versions''' listed table. You must '''match''' the correct component packages (Graphic, Codec) versions with the BSP version you are using. | ||
{| class="wikitable" | {| class="wikitable" | ||
|- style="vertical-align: top;" | |- style="vertical-align: top;" =="============================================" | ||
| style="width:500px" |. | |||
|'''VLP v3.0.4''' | |||
|'''VLP v3.0.5-update3''' | |||
|- style="vertical-align: top;" =="============================================" | |||
|π¦ '''RZ/G2 Linux Package (Common for all MPU <font color="blue">β²</font> <font color="green">β²</font> <font color="orange">β²</font>Β Β )''' <br> ZIP file containing Yocto BSP and all documentation | |||
*'''Yocto Recipe''' <br> This is the actual BSP provided in a Yocto build package | |||
*'''Release Note for Linux Package''' <br>Β Build instructions, start with this document | |||
*'''Reference Boards Linux Start-up Guide''' <br>Β How to program the boot loaders into SPI flash | |||
*'''BSP Component list''' <br> List of each package and version included in the default BSP build | |||
|'''RZ/G2'''<br>(works, not official)<br><br>'''RZ/V2MA, RZ/V2M'''<br> πΎ [https://www.renesas.com/jp/en/software-tool/rzv-verified-linux-package-510-cip Download Page] | |||
|'''RZ/G2'''<br>πΎ [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-mpus/rzg-linux-platform/rzg-marketplace/verified-linux-package/rzg-verified-linux-package Download Page] <br><br>'''RZ/V2L'''<br> πΎ [https://www.renesas.com/us/en/software-tool/rzv-verified-linux-package Download Page] | |||
|- style="vertical-align: top;" =="============================================" | |||
|π¨ '''Graphics (PowerVR) and '''π¦''' Video Codec Libraries''' | |||
*For devices '''<font color="green">RZ/G2H, RZ/G2M, RZ/G2N, RZ/G2E</font>''' | |||
*The "Evaluation Version" can be downloaded immediately, but has a 2 hour timeout after every board boot. | |||
*The "Unrestricted Version" request link is at the at the bottom of the download page (see '''Note1''' below) | |||
|N/A | |||
|πΎ [https://www.renesas.com/products/microcontrollers-microprocessors/rz-mpus/rzg-linux-platform/rzg-marketplace/verified-linux-package/rz-mpu-multimedia-package-rzg2h-rzg2m-rzg2n-and-rzg2e Requires V1.0.2] | |||
|- style="vertical-align: top;" =="============================================" | |||
|π¨ '''Graphics (Mali) Libraries''' | |||
*For devices <font color="blue">'''RZ/G2L, RZ/G2LC'''</font>, <font color="orange">'''RZ/V2L'''</font> | |||
*The "Evaluation Version" can be downloaded immediately, but has a '''2 hour timeout''' after every board boot. | |||
*The "Unrestricted Version" request link is at the at the bottom of the download page (see '''Note1''' below) | |||
|'''RZ/G2L'''<br>(use V2L V1.1.0)<br><br>'''RZ/V2L'''<br>πΎ [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rz-mpu-graphics-library-evaluation-version-rzv2l Requires V1.1.0] | |||
|'''RZ/G2L'''<br>πΎ [https://www.renesas.com/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-mali-graphic-library-evaluation-version Requires V1.1.2] <br><br>'''RZ/V2L'''<br> | |||
|- style="vertical-align: top;" ============================================== | |||
|π¦ '''Video Codec Libraries''' | |||
*For devices <font color="blue">'''RZ/G2L'''</font> and '''<font color="orange">RZ/V2L</font>''' | |||
|'''RZ/G2L'''<br>(use V2L V1.1.0)<br><br>'''RZ/V2L'''<br>πΎ [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rz-mpu-video-codec-library-evaluation-version-rzv2l Requires V1.1.0] | |||
|'''RZ/G2L'''<br>πΎ [https://www.renesas.com/software-tool/video-codec-library-evaluation-version-rzg2l-and-rzv2l Requires V1.1.0]<br><br>'''RZ/V2L'''<br> | |||
|- style="vertical-align: top;" ============================================== | |||
|π '''HTML5 Browser (Gecko/Firefox)'''Β | |||
*For devices <font color="blue">'''RZ/G2L'''</font>Β '''<font color="green">RZ/G2H, RZ/G2M, RZ/G2N, RZ/G2E</font>''' | |||
| | | | ||
| | |π¨οΈ [https://www.renesas.com/us/en/software-tool/rz-mpu-html5-gecko-package-v10-verified-linux-packages-510-cip V2.0.3 (Gecko102)] | ||
|- style="vertical-align: top;" ============================================== | |||
|π '''BSP Manual Set''' <br> Detailed information about Device Drivers and Device Tree Settings | |||
| colspan="2" |π [https://www.renesas.com/eu/en/document/rzg2-group-bsp-manual-set?language=en RZ/G2H, RZ/G2M, RZ/G2N, and RZ/G2E (link)] | |||
π [https://www.renesas.com/document/oth/rzg2l-group-bsp-manual-set?language=en RZ/G2L,RZ/G2LC, RZ/G2UL, RZ/V2L (link)] | |||
|- style="vertical-align: top;" | |||
| | |||
| | |||
| | |||
|} | |} | ||
*'''Note1 - Unrestricted Versions:''' When requesting the "Unrestricted Version", additional information about your product might be required. Additionally, but please allow '''up to 2 weeks''' for the request to complete due to internal license processing. When you submit a request, you will instantly get an email confirmation, but you will not get another email until the request has been completed. | |||
* | |||
<br> | <br> | ||
== Linux Kernel 4.19 BSP== | |||
*<font size="+2">'''RZ/G2E, RZ/G2N, RZ/G2M, RZ/G2H'''</font> | |||
*<font size="+1"> β [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-cortex-a-mpus/rzg-linux-platform/rzg-marketplace/verified-linux-package Official RZ/G2 BSP Download Page] </font> | |||
** Refer to '''Linux Package for 64-bit RZ/G2 (Kernel 4.19)''' | |||
*Links to '''Old BSP Releases''' can be found on the last page of the '''Easy Download Guide''' | |||
**https://www.renesas.com/us/en/document/gde/rzg2h-m-n-e-easy-download-guide | |||
*The '''Evaluation Version''' can be downloaded immediately, but there is a '''timeout''' on the proprietary graphics and video codec libraries. | |||
*The '''Product Version''' is available at the bottom of the page, and the timeout is removed, but due to license processing, it requires '''1 to 2 weeks''' before download. | |||
*π¦ '''RZ/G2 Group Multimedia Package''' | |||
**Separate Download for Graphics and Multimedia Libraries. Here you will find a link to request the '''Product Version''' (no timeout) | |||
**https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-cortex-a-mpus/rzg-linux-platform/rzg-marketplace/verified-linux-package/rzg2-mlp-eva | |||
*π¦ '''RZ/G2 Group BSP Manual Set''' | |||
**Detailed information about Device Drivers and Device Tree Settings | |||
**https://www.renesas.com/eu/en/document/rzg2-group-bsp-manual-set?language=en | |||
Β | |||
Β | |||
<br> | |||
= BSP Differences Between renesas.com Download and Github Version = | = BSP Differences Between renesas.com Download and Github Version= | ||
Below are the differences between BSP you download from renesas.com and what is available on public repositories. | Below are the differences between BSP you download from renesas.com and what is available on public repositories. | ||
'''Public Repository Clones'''<br> | '''Public Repository Clones'''<br> | ||
* meta- | * The only directories created by Renesas are the meta-renesas (for Linux-5.10 BSP) meta-rzg2 (for Linux-4.19 BSP). | ||
* When you download the BSP from Renesas, there are multiple Yocto (meta-xxx) directories. However, these directories are direct clones (no modifications) from public repositories. The repository URLs and commit IDs that were used are documented in the README.md README.md file in the meta-renesas or meta-rzg2 directory in the BSP. | |||
* meta- | |||
Β | |||
Β | |||
Β | |||
Β | |||
Β | |||
'''Non-public Patches'''<br> | '''Non-public Patches'''<br> | ||
* extra/ | *extra/ | ||
This directory is only in the package downloaded from renesas.com<br> | This directory is only in the package downloaded from renesas.com<br> | ||
It contains patches that are not included in the public the meta-rzg2 repository on github. For example, the patches to enable HDMI on the boards were not posted to github because of potential license issues. | It contains patches that are not included in the public the meta-renesas or meta-rzg2 repository on github. For example, the patches to enable HDMI on the boards were not posted to github because of potential license issues. | ||
'''Example Layers (Linux 4.19 BSP only)'''<br> | |||
*meta-hmi-custom/ | |||
*meta-userboard/ | |||
These directories do not have any functionally. They are simple example templates you can use to make your own customer layers. They are only included in the renesas.com package. | |||
'''Video and Multi-media Drivers'''<br> | '''Video and Multi-media Drivers (Linux 4.19 BSP only)'''<br> | ||
* proprietary/ | *proprietary/ | ||
This directory is only in the package downloaded from renesas.com<br> | This directory is only in the package downloaded from renesas.com<br> | ||
This directory contains .zip files which are essentially the propriety closed source video and multimedia drivers. They used to be downloaded separately, but are now included when downloaded the BSP from renesas.com. When following the instructions in the "Renesas Note" that comes with the BSP, users will run the script copy_proprietary_softwares.sh which will unpack these zip files into various directories under meta-rzg2. | This directory contains .zip files which are essentially the propriety closed source video and multimedia drivers. They used to be downloaded separately, but are now included when downloaded the BSP from renesas.com. When following the instructions in the "Renesas Note" that comes with the BSP, users will run the script copy_proprietary_softwares.sh which will unpack these zip files into various directories under meta-rzg2. | ||
'''This is only for the 4.19 BSP. For newer BSPs, the meta-rz-features directory is used.''' | |||
= Changes to Github Break BSP Builds = | = Changes to Github Break BSP Builds= | ||
'''The Issue:''' | '''The Issue:''' Β | ||
* Please be aware that changes to github.com effect older Yocto Recipes. | *Please be aware that changes to github.com effect older Yocto Recipes. | ||
* In summary, Yocto recipes that use git:// for the SRC URL will no longer work. | *In summary, Yocto recipes that use git:// for the SRC URL will no longer work. | ||
* More details from Github [https://github.blog/2021-09-01-improving-git-protocol-security-github can be found here]. | *More details from Github [https://github.blog/2021-09-01-improving-git-protocol-security-github can be found here]. | ||
* Yocto has been updating the recipes to use https:// instead. For example, [https://git.yoctoproject.org/poky/commit/?h=dunfell&id=0810ac6b926cd901f0619e95f367efc79d4c3159 see this patch] for Dunfell. | *Yocto has been updating the recipes to use https:// instead. For example, [https://git.yoctoproject.org/poky/commit/?h=dunfell&id=0810ac6b926cd901f0619e95f367efc79d4c3159 see this patch] for Dunfell. | ||
'''The Workaround''' | '''The Workaround''' | ||
* For building a BSP that contain recipes that still use git://, you use the command below. | *For building a BSP that contain recipes that still use git://, you use the command below. | ||
* Since this command uses --global, you only have to run it once on your PC. | *Since this command uses --global, you only have to run it once on your PC. | ||
<pre> | <pre> | ||
$ git config --global url.https://github.com/.insteadOf git://github.com/ | $ git config --global url.https://github.com/.insteadOf git://github.com/ | ||
</pre> | </pre> | ||
= SPI Flash Driver for BSP 1.0.6 = | =SPI Flash Driver for BSP 1.0.6= | ||
SPI flash write from Linux is not officially supported in V1.0.6 BSP. If you want SPI write enabled for BSP 1.0.6. Please follow the below steps: | SPI flash write from Linux is not officially supported in V1.0.6 BSP. If you want SPI write enabled for BSP 1.0.6. Please follow the below steps: |
Latest revision as of 11:35, 1 March 2024
Overview
- The Renesas BSPs for MPUs are distributed as Yocto builds.
- Renesas specific portions (boot loader, kernel, etc..) are store in github which is where the Yocto recipes pull from.
- Additional Yocto patch files are included in the renesas.com download packages that you will not find on github.
- Some libraries (graphics and video codecs) are proprietary can only be downloaded from renesas.com after registering.
- For the structure of the BSPs, there are a common Yocto layers that are used to build most Renesas software for each MPU. However, additional 'optional' software components are distributed and downloaded as "Features". There is a meta-rz-features Yocto layer directory where individual Yocto recipes can be added to a build if needed.
- The diagram on the above shows the common Yocto build in blue, and the optional Feature Packages that can be added. (Click for full size)
- The Linux kernel is based off the Civil Infrastructure Platform (CIP) which is based off the official stable kernel trees.
- The CIP project aims to backport bug fixes and security patches for 10 years.
- The diagram on the right shows the timeline for the kernel versions used in the Renesas BSPs.
Downloads
Linux Kernel 5.10 BSP
- RZ/G2 Series: RZ/G2L, RZ/G2LC, RZ/G2UL, RZ/G2E, RZ/G2N, RZ/G2M, RZ/G2H
- RZ/V2 Series: RZ/V2L
- Verified Linux Package [5.10-CIP] Version 3.0.x
- β Official RZ/G2 BSP Download Page
- β Official RZ/V2 BSP Download Page
- Please Download the individual components required for your MPU.
- Please use the package versions listed table. You must match the correct component packages (Graphic, Codec) versions with the BSP version you are using.
. | VLP v3.0.4 | VLP v3.0.5-update3 |
π¦ RZ/G2 Linux Package (Common for all MPU β² β² β² ) ZIP file containing Yocto BSP and all documentation
|
RZ/G2 (works, not official) RZ/V2MA, RZ/V2M πΎ Download Page |
RZ/G2 πΎ Download Page RZ/V2L πΎ Download Page |
π¨ Graphics (PowerVR) and π¦ Video Codec Libraries
|
N/A | πΎ Requires V1.0.2 |
π¨ Graphics (Mali) Libraries
|
RZ/G2L (use V2L V1.1.0) RZ/V2L πΎ Requires V1.1.0 |
RZ/G2L πΎ Requires V1.1.2 RZ/V2L |
π¦ Video Codec Libraries
|
RZ/G2L (use V2L V1.1.0) RZ/V2L πΎ Requires V1.1.0 |
RZ/G2L πΎ Requires V1.1.0 RZ/V2L |
π HTML5 Browser (Gecko/Firefox)
|
π¨οΈ V2.0.3 (Gecko102) | |
π BSP Manual Set Detailed information about Device Drivers and Device Tree Settings |
π RZ/G2H, RZ/G2M, RZ/G2N, and RZ/G2E (link) |
- Note1 - Unrestricted Versions: When requesting the "Unrestricted Version", additional information about your product might be required. Additionally, but please allow up to 2 weeks for the request to complete due to internal license processing. When you submit a request, you will instantly get an email confirmation, but you will not get another email until the request has been completed.
Linux Kernel 4.19 BSP
- RZ/G2E, RZ/G2N, RZ/G2M, RZ/G2H
- β Official RZ/G2 BSP Download Page
- Refer to Linux Package for 64-bit RZ/G2 (Kernel 4.19)
- Links to Old BSP Releases can be found on the last page of the Easy Download Guide
- The Evaluation Version can be downloaded immediately, but there is a timeout on the proprietary graphics and video codec libraries.
- The Product Version is available at the bottom of the page, and the timeout is removed, but due to license processing, it requires 1 to 2 weeks before download.
- π¦ RZ/G2 Group Multimedia Package
- Separate Download for Graphics and Multimedia Libraries. Here you will find a link to request the Product Version (no timeout)
- https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-cortex-a-mpus/rzg-linux-platform/rzg-marketplace/verified-linux-package/rzg2-mlp-eva
- π¦ RZ/G2 Group BSP Manual Set
- Detailed information about Device Drivers and Device Tree Settings
- https://www.renesas.com/eu/en/document/rzg2-group-bsp-manual-set?language=en
BSP Differences Between renesas.com Download and Github Version
Below are the differences between BSP you download from renesas.com and what is available on public repositories.
Public Repository Clones
- The only directories created by Renesas are the meta-renesas (for Linux-5.10 BSP) meta-rzg2 (for Linux-4.19 BSP).
- When you download the BSP from Renesas, there are multiple Yocto (meta-xxx) directories. However, these directories are direct clones (no modifications) from public repositories. The repository URLs and commit IDs that were used are documented in the README.md README.md file in the meta-renesas or meta-rzg2 directory in the BSP.
Non-public Patches
- extra/
This directory is only in the package downloaded from renesas.com
It contains patches that are not included in the public the meta-renesas or meta-rzg2 repository on github. For example, the patches to enable HDMI on the boards were not posted to github because of potential license issues.
Example Layers (Linux 4.19 BSP only)
- meta-hmi-custom/
- meta-userboard/
These directories do not have any functionally. They are simple example templates you can use to make your own customer layers. They are only included in the renesas.com package.
Video and Multi-media Drivers (Linux 4.19 BSP only)
- proprietary/
This directory is only in the package downloaded from renesas.com
This directory contains .zip files which are essentially the propriety closed source video and multimedia drivers. They used to be downloaded separately, but are now included when downloaded the BSP from renesas.com. When following the instructions in the "Renesas Note" that comes with the BSP, users will run the script copy_proprietary_softwares.sh which will unpack these zip files into various directories under meta-rzg2.
This is only for the 4.19 BSP. For newer BSPs, the meta-rz-features directory is used.
Changes to Github Break BSP Builds
The Issue:
- Please be aware that changes to github.com effect older Yocto Recipes.
- In summary, Yocto recipes that use git:// for the SRC URL will no longer work.
- More details from Github can be found here.
- Yocto has been updating the recipes to use https:// instead. For example, see this patch for Dunfell.
The Workaround
- For building a BSP that contain recipes that still use git://, you use the command below.
- Since this command uses --global, you only have to run it once on your PC.
$ git config --global url.https://github.com/.insteadOf git://github.com/
SPI Flash Driver for BSP 1.0.6
SPI flash write from Linux is not officially supported in V1.0.6 BSP. If you want SPI write enabled for BSP 1.0.6. Please follow the below steps:
1. Add kernel patches to BSP
1.a) Please get required patch files from https://github.com/seebe/rzg_stuff/tree/master/build_scripts/vlp64_patches/BSP-1.0.6-SPI-write/kernel
$ rzg2_bsp_eva_v106/recipes-kernel/linux/linux-renesas/patches $ mkdir v1.0.6_spi_patch $ cd v1.0.6_spi_patch #copy patch files here
1.b) Update patches.scc file:
Yocto uses .scc file to apply patches located in ~/rzg2_bsp_eva_v106/meta-rzg2/recipes-kernel/linux/linux-renesas/patches.scc. Get updated .scc file from https://github.com/seebe/rzg_stuff/tree/master/build_scripts/vlp64_patches/BSP-1.0.6-SPI-write/
$ cd ~/rzg2_bsp_eva_v106/meta-rzg2/recipes-kernel/linux/linux-renesas/ $ wget https://raw.githubusercontent.com/seebe/rzg_stuff/master/build_scripts/vlp64_patches/BSP-1.0.6-SPI-write/patches.scc
2. Configuring kernel using menuconfig
Configure the kernel to enable Renesas SPI driver and SPI memory. The following commands initialize the BitBake environment, run the do_kernel_configme task, and launch menuconfig. These commands assume the Source Directory's top-level folder is ~/rzg2_bsp_eva_v106:
$ cd rzg2_bsp_eva_v106 $ source poky/oe-init-build-env $ bitbake linux-renesas -c kernel_configme -f $ bitbake linux-renesas -c menuconfig
Once menuconfig comes up, configure below kernel configuration parameters.
2.a)Enable Renesa RPC-IF driver:
.config - Linux/arm64 4.19.140 Kernel Configuration > Device Drivers > Memory Controller drivers
2.b)Enable SPI memory (M25P80 ):
.config - Linux/arm64 4.19.140 Kernel Configuration > Device Drivers > Memory Technology Device (MTD) support > Self-contained MTD device drivers
After making your changes, simply exit the tool and save your changes to create an updated version of the .config configuration file
3. Build the image using updated BSP