RZ-V/RZ-V2L SMARC: Difference between revisions

From Renesas.info
(Updated image)
Line 105: Line 105:
Β  ### Extract the ISP Support Package (meta-rz-features.tar.gz ).
Β  ### Extract the ISP Support Package (meta-rz-features.tar.gz ).
Β  cd $WORK_DIR
Β  cd $WORK_DIR
Β  unzip $SRC_DIR/r11an0561ej0120-rzv2l-isp-sp.zip
Β  unzip $SRC_DIR/r11an0561ej0120-rzv2l-isp-sp.zip -d isp
Β  tar -zxvf isp/r11an0561ej0120-rzv2l-isp-sp/meta-rz-features.tar.gz
Β  tar -zxvf isp/r11an0561ej0120-rzv2l-isp-sp/meta-rz-features.tar.gz
Β Β  Β 
Β Β  Β 

Revision as of 00:31, 15 November 2022

image 2022-10-31 201234042.png

General Information

Sharing of RZ/G2L Board Documentation

RZ/V2L Boot Loaders Warning

⚠️ Warning.

The pre-loaded bootloaders (u-boot and ARM Trusted Firmware) on the RZ/V2L Evaluation Kit (SMARC board) are not up to date with the current BSP. It is strongly recommended that the bootloaders generated when building the BSP described in the Startup Guide document that is distributed with the BSP Package.

Known issues with pre-loaded loaders.

  • DRP Demos will prematurely exit.
  • ISP Demos will prematurely exit.
  • RZV2L Multi-OS CM33 Debug fails connection

Getting Started

1. Software BSP Components

Up to 5 packages are used to build the BSP.

Please download from the Official RZ/V2L Website. Please look in the "Software Downloads" section.

Links to all the downloads can be found on the πŸ“¦ RZ/V2 Linux BSP on this site. Please refer to the sections that support RZ/V2L.

Copy all ZIP file to a Linux PC.

The evaluation versions contain a time limitation that stops the software after a few hours.

  • RZ/V Verified Linux Package: RTK0EF0045Z0024AZJ-<version>.zip.
  • RZ MPU Graphics Library Evaluation Version: RTK0EF0045Z13001ZJ-<version>_EN.zip
  • RZ MPU Video Codec Library Evaluation Version: RTK0EF0045Z15001ZJ-<version>_EN.zip
  • RZ/V2L DRP-AI Support Package: r11an0549ej<version>-rzv2l-drpai-sp.zip
  • RZ/V2L ISP Support Package ("Simple ISP" by DRP-AI): r11an0561ej<version>-rzv2l-isp-sp.zip.

(*): Refer to DRP-AI Demos section for changes to the DRP-AI package that could effect you application.


2. Build Environment

  • To build the BSP, you will need a Linux PC running Ubuntu 20.04. Only this Host OS version was tested.
  • You can use a Linux PC (recommended) or a Virtual Machine. If using a Virtual Machine, 200GB of hard drive space is recommended.


3. Build the BSP

  • ⚠️ The complete build environment created by 'Linux BSP package' + 'DRP-AI Support package' + 'ISP Support package' must be combined into the same directory.
  • Use the directory name "rzv_vlp_v3.0.0"
  • Detailed instructions for setup and building are located in the Release Note documents included in each ZIP package for "Linux BSP" and "DRP-AI Support".
  • ⚠️ You must first follow the Linux BSP Release Note instructions Section 3.1, but stop πŸ›‘ before the 'bitbake' command.
    • Then, follow DRP-AI Support 'Release Note' (r11an0549ej<version>-rzv2l-drpai-sp.pdf) Sections 3.1 and 3.2, but stop πŸ›‘ before the 'bitbake' command.
    • Finally Follow the ISP Support 'Release Note' ( r11an0561ej<version>-rzv2l-isp-sp.pdf) Section 2.0.
  • A summary of the instructions located in the Release Notes are below. Simply Copy/Paste the commands.
Simple build instructions for BSP v3.00 update2   
These instructions are a summary of what is explained in the package Release Notes.
export WORK_DIR=$PWD/rzv2l_bsp_v3.00 export SRC_DIR=../ mkdir $WORK_DIR

### Extract the BSP Linux package
cd $WORK_DIR 
unzip $SRC_DIR/RTK0EF0045Z0024AZJ-v3.0.0-update2.zip
tar -xf ./RTK0EF0045Z0024AZJ-v3.0.0-update2/rzv_bsp_v3.0.0.tar.gz

### Copy/Move the 'RZV2L Graphics Library v1.2' Zip file (RTK0EF0045Z13001ZJ-v1.2_EN.zip) under the BSP directory.
cd $WORK_DIR
unzip $SRC_DIR/RTK0EF0045Z13001ZJ-v1.2_EN.zip
tar zxvf RTK0EF0045Z13001ZJ-v1.2_EN/meta-rz-features.tar.gz

### Copy/Move the 'RZV2L Video Codec Library v0.58' Zip file (RTK0EF0045Z13001ZJ-v0.51_forV2L_EN.zip) under the BSP directory.
cd $WORK_DIR
unzip $SRC_DIR/RTK0EF0045Z15001ZJ-v0.58_EN.zip
tar zxvf RTK0EF0045Z15001ZJ-v0.58_EN/meta-rz-features.tar.gz

### Copy/Move the DRP Support archive file ( r11an0549ej0720-rzv2l-drpai-sp.zip ) 
### Extract the 'DRP-AI Driver Support' package file (meta-rz-features.tar.gz) under the rzv2l_drpai-driver directory.
unzip $SRC_DIR/r11an0549ej0720-rzv2l-drpai-sp.zip -d drp
tar -xvf drp/rzv2l_drpai-driver/meta-rz-features.tar.gz

### Copy/Move the ISP Support archive file ( r11an0561ej0120-rzv2l-isp-sp.zip ) 
### Extract the ISP Support Package (meta-rz-features.tar.gz ).
cd $WORK_DIR
unzip $SRC_DIR/r11an0561ej0120-rzv2l-isp-sp.zip -d isp
tar -zxvf isp/r11an0561ej0120-rzv2l-isp-sp/meta-rz-features.tar.gz
 
### Set up the Yocto Environment and copy a default configuration
cd $WORK_DIR
source poky/oe-init-build-env
cp ../meta-renesas/docs/template/conf/smarc-rzv2l/*.conf ./conf/
### Build
bitbake core-image-weston
bitbake core-image-weston -c populate_sdk

Verification

After the above script is run there will be a new folder call meta-rz-features. This will include, among others sub-folders for the MALI GPU, Video Codec, DRP, and ISP.

  • recipes-codec
  • recipes-drpai
  • recipes-isp

In addition depending if the DRP and/or ISP is installed, the meta-rz-features layers recipe will look like code snippet below.

meta-rz-feature/conf/layer.conf
# We have a conf and classes directory, add to BBPATH

include ${LAYERDIR}/include/graphic/feature.inc
include ${LAYERDIR}/include/codec/plugin.inc
include ${LAYERDIR}/include/demos/demos.inc

LAYERDEPENDS_rz-features = "rzg2" 

BBPATH .= ":${LAYERDIR}"

BBFILE_COLLECTIONS += "rz-features"
BBFILE_PATTERN_rz-features := "^${LAYERDIR}/"

# We have recipes-* directories, add to BBFILES
BBFILES += "${LAYERDIR}/recipes-*/*/*.bb \
    ${LAYERDIR}/recipes-*/*.bb \
    ${LAYERDIR}/recipes-*/*.bbappend \
    ${LAYERDIR}/recipes-*/*/*.bbappend"

# Add DRP-AI Support PKG
DRPAI_RECIPES = "${@os.path.isdir("${LAYERDIR}/recipes-drpai")}"

BBFILES_append += "${@'${LAYERDIR}/recipes-drpai/*/*/*.bb' if '${DRPAI_RECIPES}' == 'True' else ''} \
                   ${@'${LAYERDIR}/recipes-drpai/*/*/*/*.bb' if '${DRPAI_RECIPES}' == 'True' else ''} \
                   ${@'${LAYERDIR}/recipes-drpai/*/*/*.bbappend' if '${DRPAI_RECIPES}' == 'True' else ''} \
                   ${@'${LAYERDIR}/recipes-drpai/*/*/*/*.bbappend' if '${DRPAI_RECIPES}' == 'True' else ''} "

# Add ISP Support PKG
ISP_RECIPES = "${@os.path.isdir("${LAYERDIR}/recipes-isp")}"

BBFILES_append += "${@'${LAYERDIR}/recipes-isp/*/*/*.bb' if '${ISP_RECIPES}' == 'True' else ''} \
                   ${@'${LAYERDIR}/recipes-isp/*/*/*/*.bb' if '${ISP_RECIPES}' == 'True' else ''} \
                   ${@'${LAYERDIR}/recipes-isp/*/*/*.bbappend' if '${ISP_RECIPES}' == 'True' else ''} \
                   ${@'${LAYERDIR}/recipes-isp/*/*/*/*.bbappend' if '${ISP_RECIPES}' == 'True' else ''} "

RZV2L Multi-OS Support

To add Multi-OS Support follow the instructions RZV2L Cortex-M33 Multi-OS Package.


4. Prepare an SD Card

  • The evaluation boards can be booted from SD Cards. The SD card must be formatted and loaded using a Linux PC. A helpful script has been created (usb_sd_partition) that you can run on your Linux PC.
  • Insert your micro SD card into a USB-SD-Card reader and then plug into a Linux PC.
  • Use the commands below to download the formatting script and run. Please select your card and choose the default settings.
$ wget https://raw.githubusercontent.com/renesas-rz/rzg2_bsp_scripts/master/usb_sd_partition/usb_sd_partition.sh
$ chmod +x usb_sd_partition.sh
$ ./usb_sd_partition.sh
  • Use the commands below to copy the files you build with the BSP to the SD card. Start in the base of your Yocto BSP.
# Change to the Yocto output directory that contains the files
$ cd build/tmp/deploy/images/smarc-rzv2l

# Copy the Linux kernel and Device Tree to partition 1
$ sudo cp -v Image /media/$USER/RZ_FAT
$ sudo cp -v r9a07g054l2-smarc.dtb /media/$USER/RZ_FAT

# Copy and expand the Root File System to partition 2
$ sudo tar -xvf core-image-weston-smarc-rzv2l.tar.gz   -C /media/$USER/RZ_ext
    (or if NOT using graphics)
$ sudo tar -xvf core-image-minimal-smarc-rzv2l.tar.gz   -C /media/$USER/RZ_ext

# Make sure all files are finished writing before removing the USB card reader from the PC
$ sync
  • Safely remove your USB card reader by right clicking on the drive icon (either RZ_FAT or RZ_ext) in Ubuntu and selecting "Eject"

5. Power the Board and Connect to the Serial Port

  • Supply power the board using the USB-C connection on the carrier board labeled "Power Input"
  • On the carrier board, press the red button in order to turn on power to the board. The green LED labeled "Carrier PWR On" will be lit when power is on.
  • Now that the board is powered, plug a USB micro cable into the carrier board to the USB connector labeled "SER 3 UART". Use a serial terminal program to interact as you board. With a Linux PC, we recommend using "putty" (connects to /dev/USB0), and with a Windows PC we recommend "TeraTerm" that connects to COMx. The baud rate of the Serial connection is 115200 bps.
  • Press the blue reset button, and then "u-boot" will start. Within 3 seconds, press the space bar on your keyboard in order to stop the auto-boot sequence.


6. Switch settings for the CPU SOM board.

  • The SOM board contains a eMMC Flash device and a Micro SD Card socket. On the SOM board, you can only use one or the other because they are both connected to the same peripheral channel on the RZ/V2L.
  • Set the switches on the SOM board to what you want to use.
  • ⚠️ u-boot environment variables are always stored in eMMC Flash (not SPI flash). This means if you change switch SW1-2 to OFF on the SOM board, you cannot access saved u-boot environments variables and you will always get the message "*** Warning - MMC init failed, using default environment"
  • Note that the SD Card slot on the Carrier board will always work regardless of the setting of SW1-2 because it uses a separate peripheral channel on the RZ/V2L.
  • On the SOM (CPU) board, there is a little switch (SW1) near the SD card socket.
SOM board uses SD Card socket                 SOM board uses eMMC Flash (recommended)
SW1-1 = ON/OFF(JTAG)                          SW1-1 = ON/OFF(JTAG)
SW1-2 = ON                                    SW1-2 = OFF
      +-----+                                       +-----+
      | ON  |                                       | ON  |
      | = = |                                       | =   |
      |     |                                       |   = |
      | 1 2 |                                       | 1 2 |
      +-----+                                       +-----+


7. Boot the Board

Choose option 7-1 or 7-2 or 7-3 below.
Option 7-1 is recommended.


7-1. Boot the Board using SD Card on Carrier Board (Recommended)

  • Insert the SD card into the socket on Carrier Board.
β”Œβ”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”
β”‚     β”‚ SOM β”‚     β”‚
β”‚     β””β”€β”€β”€β”€β”€β”˜     β”‚
β”‚  Carrier Board  β”‚
β”‚     β”Œβ”€β”         β”‚
β””β”€β”€β”€β”€β”€β”΄β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
       ↑
 SD Card Socket
  • Press the blue reset button, and then "u-boot" will start. Within 3 seconds, press the space bar on your keyboard in order to stop the auto-boot sequence.
  • At the u-boot prompt ( => ), enter the following commands to boot the board:
   # Create command macros and save them:
=> setenv sd_boot1 'mmc dev 1 ; fatload mmc 1:1 0x48080000 Image ; fatload mmc 1:1 0x48000000 r9a07g054l2-smarc.dtb'
=> setenv sd_boot2 'setenv bootargs 'root=/dev/mmcblk1p2 rootwait' ; booti 0x48080000 - 0x48000000'
=> setenv bootcmd 'run sd_boot1 sd_boot2'
=> saveenv

   # Reset the board and it will automatically boot

7-2. Boot the Board using eMMC Flash on SOM Board (Advanced)

  • Set switch SW1-2 = OFF
  • The boot loader (u-boot) by default will try to boot from eMMC after 3 seconds.
  • Press the blue reset button and wait.

7-3. Boot the Board using SD Card on SOM Board (eMMC Flash disabled) (Advanced)

  • Set switch SW1-2 = ON
  • Insert the SD card into the socket on SMARC SOM CPU board (not the carrier board).
  • Press the blue reset button, and then "u-boot" will start. Within 3 seconds, press the space bar on your keyboard in order to stop the auto-boot sequence.
  • Note that you will get this message every time "*** Warning - MMC init failed, using default environment" because u-boot environment variables are stored in eMMC Flash (that you disabled)
  • At the u-boot prompt ( => ), enter the following commands to boot the board:
  # Manually enter the following commands to boot
=> mmc dev 0 ; fatload mmc 0:1 0x48080000 Image ; fatload mmc 0:1 0x48000000 /r9a07g054l2-smarc.dtb
=> setenv bootargs 'root=/dev/mmcblk0p2 rootwait' ; booti 0x48080000 - 0x48000000


8. Linux Login

  • The login will be "root" (no password is needed)

Programming Boot Loaders into SPI Flash

  • The RZ/V2L board come pre-programmed with the boot loaders in SPI Flash. Normally, they should not need to be updated.
  • However, if you wish to update them, please refer to the document RZV2L_SMARC_EVK_Start-up_Guide_rev0.8.pdf for instruction.
  • ⚠️ The RZ/V2L BSP v0.8 will build the bootloader binaries (bl2_bp-smarc-rzv2l.srec, fip-smarc-rzv2l.srec). However, the 'Flash Writer' binary that is needed for programming as described in the Start-up Guide is only provided as binary at this time. Please download them below:

Convert RZ/G2L BSP to RZ/V2L BSP

  • Some users have started with a RZ/G2L BSP and board and would like to migrate to RZ/VL2.
  • Since the RZ/V2L and RZ/G2L devices are very similar, the BSP software is almost the same.
  • Below are some ways you can convert the RZ/G2L BSP to build software for the RZ/V2L board.

Method #1: Build RZ/V2L files when selecting RZ/G2L in Yocto

  • The Yocto build environment for the RZ/V2L is almost same as the RZ/G2L. However, you will need to modify some files in Yocto in order to be able to build files for the RZ/V2L SMARC board.
  • These patches are only for the RZ/G2L BSP v1.3
  • File:0001-rzg2l-common-add-v2l-dtb.patch
    • This patch will include the RZ/V2L Device Tree as part of the build.
  • File:0002-bin file-overwrite-G2L-for-V2L.patch
    • This patch will build files for the RZ/V2L board even when MACHINE is set to "smarc-rzg2l"
  • After applying these patches, just build Yocto for G2L SMARC (smarc-rzg2l) as normal.


Method #2: Build Outside of Yocto

  • Some software components of the BSP are very easy to build outside of Yocto, and a Yocto environment is not needed. These are ARM Trusted Firmware, u-boot and Flash Writer. These software components can be built completely independent of Yocto.
  • In general, the same Root File System (rootfs) of a Linux system can be used on many different boards. For example, the rootfs of the RZ/V2L board is almost identical to the rootfs of the RZ/G2L, and you can swap them. Of course, the applications loaded into each might be different, but booting is always possible.
  • The Linux kernel also does not require Yocto to be built, however, some output files such as kernel modules will need to be copied to the root file systems that Yocto builds.
  • Build scripts are available to built BSP software components outside of Yocto. Please see below.
Build Instructions for RZ/V2L Software Components                              

Use the commands below to prepare a build environment for the RZ/V2L SMARC board.

# Download and install a toolchain
cd /tmp
wget https://developer.arm.com/-/media/Files/downloads/gnu-a/10.2-2020.11/binrel/gcc-arm-10.2-2020.11-x86_64-aarch64-none-elf.tar.xz
sudo mkdir -p /opt/arm
cd /opt/arm
sudo tar xvf /tmp/gcc-arm-10.2-2020.11-x86_64-aarch64-none-elf.tar.xz

# Download Build Scripts
cd /home/$USER    # Choose your own location
git clone https://github.com/renesas-rz/rzg2_bsp_scripts

# Download source code repositories
cd build_scripts
git clone --branch rz_g2l         https://github.com/renesas-rz/rzg2_flash_writer
git clone --branch v2.5/rzg2l     https://github.com/renesas-rz/rzg_trusted-firmware-a
git clone --branch v2020.10/rzg2l https://github.com/renesas-rz/renesas-u-boot-cip

# Build
./build.sh s      # Select RZ/V2L SMARC, and the toolchain "ARM gcc-arm-10.2-2020.11" you downloaded
./build.sh f      # Build Flash Writer
./build.sh u      # Build u-boot
./build.sh t      # Build Trusted Firmware-ARM


RZV2L ISP Demos

Requirements
  • Linux BSP SDK : The SDK must include the DRP-AI and ISP packages. Refer to Linux BSP Release Note instructions (r01an6221ej<version>-rzv2l-linux.pdf) Section 6.
  • RZV2L DRP-AI Sample Application : ( rzv2l_drpai-sample-application_ver5.00.tar.gz )
  • Power : A powered hub or PC may not provide sufficient power. A USB Power Block is suggested.
Build ISP Monitoring Application

Detailed instructions for setup and building are located in the Application Note Revision documents in "Simple ISP Sample Application Note Revision" package.

  • ⚠️ You must first follow the Simple ISP Sample Application Note Revision instructions (r11an0563ej<version>-rzv2l-simple-isp.pdf) Section 2.0 and 2.6
Simple build instructions for ISP Monitioring Application     

These instructions are a summary of what is explained in the package Release Notes.

export ISP_FILE=r11an0561ej0100-rzv2l-isp-sp.zip

# Step 1. Extract the ISP package and ISP sample application files. Enter the ISP Montitoring source directory.
unzip $ISP_FILE -d isp_work
cd isp_work
tar zxvf rzv2l_isp-sample-application_ver1.00.tar.gz
cd app_isp_monitoring/src

# Step 2. Start the SDK
source /opt/poky/3.1.5/environment-setup-aarch64-poky-linux

# Step 3. Build the source with make
make
Build ISP Tiny YoloV2 Application

Detailed instructions for setup and building are located in the Application Note Revision documents in "Simple ISP Sample Application Note Revision" package.

  • ⚠️ You must first follow the Simple ISP Sample Application Note Revision instructions (r11an0563ej<version>-rzv2l-simple-isp.pdf) Section 2.0 and 2.7

This build requires the DRP-AI Tiny Yolo V2 Cam source is needed for this build ( /rzv2l_drpai-sample-application/app_tinyyolov2_cam/src ).

This build requires the DRP-AI Tiny Yolo V2 Cam directory "tinyyolov2_cam" is needed for this build ( /rzv2l_drpai-sample-application/app_tinyyolov2_cam/exe ).

Simple build instructions for ISP Tiny Yolo V2 Application        

These instructions are a summary of what is explained in the package Release Notes.

mkdir drp-ai-supporrt
export DRP_WORKDIR=$PWD/drp-ai-support

mkdir isp-support
export ISP_	WORKDIR=$PWD/isp-support

export APP_WORKDIR=$PWD

# Step 1. Extract the DRP Appicatiion Code to $DRP_WORK
unzip r11an0549ej0500-rzv2l-drpai-sp.zip -d $DRP_WORK
cd $DRP_WORK/rzv2l_drpai-sample-application/
tar -xvf rzv2l_drpai-sample-application_ver5.00.tar.gz -C .
cd $APP_WORKDIR

# Step 2. Extract the ISP Application Code to $ISP_WORK
unzip r11an0561ej0100-rzv2l-isp-sp.zip -d $ISP_WORK
cd $ISP_WORK
tar -xvf rzv2l_isp-sample-application_ver1.00.tar.gz -C .
cd $APP_WORKDIR


# Step 3. Copy TinyYoloV2 source code to ISP TinyYoloV2 application source directory
cp -r drp-ai-support/rzv2l_drpai-sample-application/app_tinyyolov2_cam/src/ ./isp-support/app_tinyyolov2_cam/src/

# Step 4. Apply Patch
cd $ISP_WORKDIR/app_tinyyolov2_cam/src/
patch -p 1 < rzv2l_app_tinyyolov2_cam_usb2mipi.patch

# Step 5. Setup SDK
source /opt/poky/3.1.5/environment-setup-aarch64-poky-linux

# Step . Build Source
make

RZV2L Cortex-M33 Multi-OS Package

The RZV2L includes a ARM CM33 MCU. This section describes how to build applications and communication between the CV55 and the CM33.

Official RZV2L Cortex-M33 Multi-OS Package

Official RZV2L Cortex-M33 FSP Getting Started

The Default RZV2L BSP U-Boot does not support Cortex-M33 Multi-OS. To enable the u-boot CM33 command and OpenAMP Multi-processor communication add below snippet to the BSP build script described Getting Started.

Getting Started Build Steps

The Multi-OS Package assume that only the BSP, Video Codec, and GPU are installed. By adding the Multi-OS package, it will overwrite the RZV2L BSP meta-rz_features layer.conf file. This will remove the DRP and/or ISP package configuration. Follow the steps below to add the MultiOS without removing the DRP and/or ISP packages

Multi-OS Package v3.0 Build steps        
### Extract the BSP Linux package
..
### Copy/Move the 'RZV2L Codec Library v0.58' Zip file (RTK0EF0045Z15001ZJ-v0.58_EN.zip) under the BSP directory.
..
### Copy/Move the 'RZV2L ARM Mali-GPU Library v1.2' Zip file (RTK0EF0045Z13001ZJ-v1.2_EN.zip) under the BSP directory.
..

### Setup the RZV2L MultiOS CM33 under the BSP, Codex and GPU directory.
### Install the and boot commands OpenAMP library
unzip $SRC_DIR/r01an6238ej0102-rzv2l-cm33-multi-os-pkg.zip
tar -zxvf r01an6238ej0102-rzv2l-cm33-multi-os-pkg/meta-rz-features.tar.gz

### Extract the 'DRP-AI Driver Support' package file (meta-rz-features.tar.gz) under the rzv2l_drpai-driver directory.
..
### Copy/Move the ISP Support archive file ( r11an0561ej0120-rzv2l-isp-sp.zip ) 
..

### Reinsert the MultiOS recipe into the meta-rz-features/conf/layers.conf
cd $WORK_DIR
sed -i '/demos.inc/a include ${LAYERDIR}/include/openamp/openamp.inc' ./meta-rz-features/conf/layer.conf

cd $WORK_DIR
source poky/oe-init-build-env
cp ../meta-renesas/docs/template/conf/smarc-rzv2l/*.conf ./conf/

### Build
bitbake core-image-weston

Flexible Software Package (FSP).

  • Documentation for the FSP can be found on the Official RZV2L Cortex-M33 Multi-OS Package
  • Release Note for RZV2L Flexible Software Package PDF
  • RZV2L FSP Documentation V1.00 PDF

Renesas e2studio IDE supports application development and debugging for the Cortex-CM33

  • Please review the RZV2L Getting Started Guide. This document includes information about setting up the IDE for RZV2L/CM33 Development, loading, and running Cortex-CM33 Applications

CM33 e2studio GDB Debug

  1. Build the BSP and downloaded the latest ARM Trust Zone Loader and Uboot. This is very important because the loaders setup the board and processor hardware ( CM33, DRP, ... ). The preinstalled loaders on the board do not properly setup the processor and board.
  2. Set the SW1 switch to enable the JTAG and SW11 to QSPI Flash or Serial Interface. ( See figure JTAG Connection and SW11 Settings ).
    JTAG Connection and SW11 Settings.
  3. Press the power button on the board. You should see three LEDS. If the USB wire is connected to the Serial Interface you should see the uboot start up.
  4. Create a RZV2L Project.
    1. Set the Board to RZV2L Evaluation Kit (SMARC). This will set the project GPIO pins correctly
    2. Device settings: R9A07G054L23GBG
    3. Debugger: J-Link ARM
    4. Choose either Mare Metal - Blinky or FreeRTOS - Blinky. Theses projects will generate the GPIO code for the LED.
  5. Compile Project
    1. If there are error check the correct compiler is selected or open the FSP perspective and click generate code.
  6. Open the Project Debug Configuration ( Run -> Debug Configuration ). Under Renesas GDB Hardware Debugging, select the configuration with the same name as your project name.
  7. In the Debug Configuration -> Debugger Check the following settings.
    1. Target Device is R9A07G054L_M33
    2. Connection Settings -> Rest on connection is set to No
  8. In the Debug Configuration -> Startup
    1. Reset and Delay is unchecked
    2. Run Commands:
set {int} 0x4102080C=0x1001FF80
set {int} 0x41020810=0x00010000
  1. Press Apply then debug.

Enable eMMcC Flash

The instructions to enable the RZV2L to boot from eMMC Flash at on the RZG2L Page here

Program On-Board eMMC Flash

The instructions to enable the RZV2L to load the Linux kernel, DTB, and Filesystem RZG2L Page here

Fix rngd bug that randomly keeps all CPUs busy after startup

RZ MPUs do not have a hardware random number generation module (/dev/hwrng), but that's the default setting for the systemd rngd service.

With that, rngd occupies the CPU resources to build up entropies during start-up.

Randomly, this process does not end properly and slows down the entire system significantly.

But if an available pseudorandom number generator is selected, rngd finishes properly always.

The following modification is sufficient:

Before you build the BSP, modify

poky/meta/recipes-support/rng-tools/rng-tools/default

from

   EXTRA_ARGS="-r /dev/hwrng"

to

   EXTRA_ARGS="-r /dev/urandom -x jitter"

However, normally you do not want to modify the original recipe but instead create a new one to override the old one.

  1. Create a new folder: mkdir - p meta-renesas/recipes-rzg2l/recipes-support/rng-tools
  2. Change dir: cd meta-renesas/recipes-rzg2l/recipes-support/rng-tools
  3. Create a new file in that folder: vi rng-tools_%.bbappend
  4. Edit the file just created and add these lines: FILESEXTRAPATHS:prepend := "${THISDIR}/${PN}:" SRC_URI += "file://default"(1)
  5. Create another folder: mkdir -p rng-tools
  6. Add a file vi default
  7. Add the new content into it: EXTRA_ARGS="-r /dev/urandom -x jitter"
  8. Rebuild the image with the new package: bitbake core-image-weston

(1) Note that this is the new Yocto syntax. For older versions of Yocto you may need to replace : (colon) with _ (underscore): so FILESEXTRAPATHS_prepend.

Alternatively, you can modify the

/etc/default/rng-tools

file in the current target rootfs accordingly.

Add HTML5 Browser to BSP v1.0.1

  • The following instructions will add Firefox and the HTML engine Gecko (ver 91) to the RZ/V2L v1.0.1 BSP. It's the same procedure as described for RZ/G2L (https://renesas.info/wiki/RZ-G/RZ-G2L_SMARC#Add_HTML5_Browser_to_BSP_v1.4). With a few minor modifications, the procedure works fine for RZ/V2L as well (tested with latest BSP v1.0.1).
  • The package "vte" (Virtual Terminal) package changed from GLPv2 to GPLv3 from v0.52 to v0.53. This package is required when build gecko. However, a patch is supplied that will revert this package to an older version in order to avoid GLPv3 license issues.
  • Sometimes when building, you will get a pseudo abort exit 134 error in Yocto. We fix that by adding the Debian packages pseudo and attr to the BSP v1.0.1. Then, it will build correctly every time.
  • First, download and configure the RZ/V2L BSP v1.0.1. Following the Release Note, do the steps in Section 3, but stop at step "(5) Start a build". We need to make some changes before we run "bitbake core-image-weston".
  • Now that you have configured the BSP, you can follow the instructions below to add HTML support.
  • For the instructions below, start at the base of the BSP v1.0.1 directory. If you are in the build directory, please do a cd .. first to get back to the base of the BSP before copy/pasting the instructions below.
  • Please note that these changes will break a core-image-qt build.
Instructions                              

Add meta layers to build Gecko91

$ git clone -b gem-firefox-91.0.0esr https://github.com/webdino/meta-browser.git
$ git clone https://github.com/meta-rust/meta-rust.git
$ git -C meta-rust checkout 1b59fd45906082c978d0a0a6e4e51a0ea4aa32c7
$ git -C meta-rust revert 647b976da2a9161ceb01ad477216480fc1c88af8 < /dev/null
$ git clone -b dunfell https://github.com/webdino/meta-clang.git

Add dummy files in meta-rzv/classes/ because the gecko recipes want to "inherit"

$ cd meta-rzv/classes
$ touch distutils.bbclass pythonnative.bbclass setuptools.bbclass
$ cd ../..

Download and apply addition patches for X11 and vte

$ cd meta-rzv
$ wget https://raw.githubusercontent.com/seebe/rzg_stuff/master/boards/rzg2l_smarc/gecko91_for_bsp_v1.4/0001-recipes-graphics-xorg-xserver-Remove-unsupported-opt.patch
$ wget https://raw.githubusercontent.com/seebe/rzg_stuff/master/boards/rzg2l_smarc/gecko91_for_bsp_v1.4/0001-recipes-gecko-add-vte-version-0.52.2.patch
$ patch -p1 < 0001-recipes-graphics-xorg-xserver-Remove-unsupported-opt.patch
$ patch -p1 < 0001-recipes-gecko-add-vte-version-0.52.2.patch
$ cd ..

Download and apply addition patches to add debian pseudo and attr

$ cd meta-rzv
$ wget https://raw.githubusercontent.com/seebe/rzg_stuff/master/boards/rzg2l_smarc/gecko91_for_bsp_v1.4/add-debian-pseudo-and-attr.patch
$ patch -p1 < add-debian-pseudo-and-attr.patch
$ cd ..

Edit the file build/conf/local.conf

$ gedit build/conf/local.conf &
  • Comment out the following line in the build/conf/local.conf by placing a "#" at the beginning of the line.
#DISTRO_FEATURES_remove = " x11"		
  • Add the following lines for Gecko91 at the end of build/conf/local.conf
IMAGE_INSTALL_append = " firefox "
IMAGE_INSTALL_append = " ttf-sazanami-gothic ttf-sazanami-mincho "
IMAGE_INSTALL_append = " pulseaudio-server "
IMAGE_INSTALL_append = " adwaita-icon-theme adwaita-icon-theme-cursors "
PACKAGECONFIG_append_pn-firefox = " openmax "
PACKAGECONFIG_append_pn-firefox = " webgl "
PACKAGECONFIG_append_pn-firefox = " gpu "
PREFERRED_VERSION_vte = "0.52.2"

TARGET_CXXFLAGS_remove_toolchain-clang = " --stdlib=libc++"
TUNE_CCARGS_remove_toolchain-clang = " --rtlib=compiler-rt --unwindlib=libunwind --stdlib=libc++"
TUNE_FEATURES_remove_toolchain-clang = "cortexa57-cortexa53"

DISTRO_FEATURES_append = " x11"
PACKAGECONFIG_remove = " libedit "

Configure bblayers.conf to add the meta-layers we downloaded (git cloned) to the build

$ source poky/oe-init-build-env
$ bitbake-layers -F add-layer $(pwd)/../meta-rust
$ bitbake-layers -F add-layer $(pwd)/../meta-clang
$ bitbake-layers -F add-layer $(pwd)/../meta-browser

Start the build

$ bitbake core-image-weston

How to launch Firefox91

  • After launching the board, please define the following variables before you launch Firefox91 with the following command.
  • We suggest that you use PMIC board with Full HD resolution(1920:1080) to evaluate HTML5.
$ export MOZ_GLXTEST_RESULT="VENDOR Proprietary RENDERER Hardware VERSION N/A TFP TRUE SCREEN_INFO 1920x1080:1; TEST_TYPE EGL"
$ export MOZ_WAYLAND_GL_LIBRARY=1

Launch in a window:

$ WAYLAND_DISPLAY=wayland-0 GDK_BACKEND=wayland MOZ_OMX_RZG2L=1 firefox --width 640 --height 480

Launch full screen: (kiosk mode, adjust resolution to match your screen),

$ WAYLAND_DISPLAY=wayland-0 GDK_BACKEND=wayland MOZ_OMX_RZG2L=1 firefox --width 1024 --height 600 --kiosk https://renesas.info

DRP-AI Demos

DRP-AI Driver Version 7.00

This version to the DRP-AI Reserve Area has changed from 0x70000000 to 0x80000000, because of this older versions of the DRP-AI Implementation Source code will fail with the following errors.

[ERROR] Failed to run DRPAI_ASSIGN : errno=22

[ERROR] Failed to run load_data_to_mem : resnet50_cam/drp_desc.bin

[ERROR] Failed to load DRPAI Data

This is due to the generated DRP Translator files map to the older address. Please use the DRP Translator version 1.70 when generating the DRP files and use the latest sample code included in the DRP-AI package version 7.0.