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

From Renesas.info
Line 18: Line 18:


= Getting Started =
= Getting Started =
'''1. Linux BSP Components'''
'''1. Software BSP Components'''
* Obtain the '''Linux BSP package''' (rzv2l_linux-pkg_ver0.8.0.zip) from the same Renesas representative that you received your board from. Unzip the contents and copy to a Linux PC.
* Obtain the '''Linux BSP package''' (rzv2l_linux-pkg_ver0.8.0.zip) from the same Renesas representative that you received your board from. Unzip the contents and copy to a Linux PC.
* Obtain the '''DRP-AI Support package''' (rzv2l_drpai-support-pkg_ver0.90.zip) from the same Renesas representative that you received your board from. Unzip the contents and copy to a Linux PC.
* Obtain the '''Codec Library package''' (RTK0EF0045Z15001ZJ_0_4_0.tar.bz2) from the same Renesas representative that you received your board from. Unzip the contents and copy to a Linux PC.
* Obtain the '''Codec Library package''' (RTK0EF0045Z15001ZJ_0_4_0.tar.bz2) from the same Renesas representative that you received your board from. Unzip the contents and copy to a Linux PC.
* Download the '''RZ/G2L Mali Graphic Library''' package (RTK0EF0045Z13001ZJ-v0.51_EN.zip) '''from this [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-mali-graphic-library-evaluation-version link]''' to enable graphs. This package is also used for this RZ/V2L board. Copy the ZIP file to a Linux PC.
* Download the '''RZ/G2L Mali Graphic Library''' package (RTK0EF0045Z13001ZJ-v0.51_EN.zip) '''from this [https://www.renesas.com/us/en/products/microcontrollers-microprocessors/rz-arm-based-high-end-32-64-bit-mpus/rzg2l-mali-graphic-library-evaluation-version link]''' to enable graphs. This package is also used for this RZ/V2L board. Copy the ZIP file to a Linux PC.
Line 28: Line 29:


'''3. Build the BSP'''
'''3. Build the BSP'''
* The instructions for building the BSP are located in the '''Release Note''' document that is included in the rzv2l_linux-pkg_ver0.8.0.zip file package.
* The complete build environment created by "Linux BSP package" + "DRP-AI Support package" (combine into the same directory).
* ⚠️ If you are building core-image-weston, you need to add '''Mali Graphics library''' mentioned in step 1.
* Detailed instructions for setup and building are located in the '''Release Note''' documents in each "Linux BSP" and "DRP-AI Support" package.
* A summary of the instructions located in the Release Note are below. Simple Copy/Paste the commands.
** ⚠️ You must first follow the Linux BSP Release Note instructions (RZV2L_Linux_Package_version_0.8.0_Release_Note.pdf) Section 3.1 (1),(2),(3),(4)
** Then follow DRP-AI Support Release Note (rzv2l_drpai-support-package_ver0.90_release-note.pdf) Sections 3.1 and 3.2
* A summary of the instructions located in the Release Notes are below. Simple Copy/Paste the commands.
{| class="mw-collapsible mw-collapsed wikitable"
{| class="mw-collapsible mw-collapsed wikitable"
| Simple build instructions for BSP v0.8        
| Simple build instructions for BSP v0.8        
|-
|-
|
|
These instructions are a summary of what is explained in the BSP Release Note.
These instructions are a summary of what is explained in the package Release Notes.
<pre>
<pre>
# Extract package
# Extract the BSP Linux package
$ mkdir rzv2l_bsp_v0.8
$ mkdir rzv2l_bsp_v0.8
$ tar -xf rzv2l_bsp_v080.tar.gz -C rzv2l_bsp_v0.8
$ tar -xf rzv2l_bsp_v080.tar.gz -C rzv2l_bsp_v0.8
$ cd rzv2l_bsp_v0.8
$ cd rzv2l_bsp_v0.8


# Copy/Move the 'Mali Graphics library' Zip file (RTK0EF0045Z13001ZJ-v0.51_EN.zip) under our BSP directory.
# Copy/Move the 'Mali Graphics library' Zip file (RTK0EF0045Z13001ZJ-v0.51_EN.zip) under the BSP directory.
# Then, we will un-zip it and install it.
$ unzip RTK0EF0045Z13001ZJ-v0.51_EN.zip
$ unzip RTK0EF0045Z13001ZJ-v0.51_EN.zip
$ cd RTK0EF0045Z13001ZJ-v0.51_EN/proprietary
$ cd RTK0EF0045Z13001ZJ-v0.51_EN/proprietary
$ ./copy_gfx_mmp.sh ../../meta-rzv
$ ./copy_gfx_mmp.sh ../../meta-rzv
$ cd ../..
$ cd ../..
# Copy/Move the 'Codec Library' package file (RTK0EF0045Z15001ZJ_0_4_0.tar.bz2) under the BSP directory.
$ tar -xvf RTK0EF0045Z15001ZJ_0_4_0.tar.bz2
$ cd meta-rzv
$ sh docs/template/copyscript/copy_proprietary_software_omx.sh  ../RTK0EF0045Z15001ZJ_0_4_0
$ cd ../


# Set up Yocto Environment
# Set up Yocto Environment
Line 54: Line 62:


# Build
# Build
$ bitbake core-image-minimal
$ bitbake core-image-weston
$ bitbake core-image-weston
$ bitbake core-image-minimal -c populate_sdk
$ bitbake core-image-weston -c populate_sdk
</pre>
</pre>
|}
|}

Revision as of 23:55, 7 September 2021

<img height="200" style="float:right" src=renesas_rzg2l_carrier.jpg> ← RZ-V

General Information

  • Official RZ/V2L Website
    • Please review the Documentation & Downloads section
  • Board Documentation
    • Since the RZ/V2L and RZ/G2L devices are pin compatible, the same evaluation board design is used for both.
  • Linux Board Support Package Download
    • The BSP is currently still in pre-release and must be obtained directly from your Renesas Sales representative.

Sharing of RZ/G2L Board Documentation

Getting Started

1. Software BSP Components

  • Obtain the Linux BSP package (rzv2l_linux-pkg_ver0.8.0.zip) from the same Renesas representative that you received your board from. Unzip the contents and copy to a Linux PC.
  • Obtain the DRP-AI Support package (rzv2l_drpai-support-pkg_ver0.90.zip) from the same Renesas representative that you received your board from. Unzip the contents and copy to a Linux PC.
  • Obtain the Codec Library package (RTK0EF0045Z15001ZJ_0_4_0.tar.bz2) from the same Renesas representative that you received your board from. Unzip the contents and copy to a Linux PC.
  • Download the RZ/G2L Mali Graphic Library package (RTK0EF0045Z13001ZJ-v0.51_EN.zip) from this link to enable graphs. This package is also used for this RZ/V2L board. Copy the ZIP file to a Linux PC.

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.

3. Build the BSP

  • The complete build environment created by "Linux BSP package" + "DRP-AI Support package" (combine into the same directory).
  • Detailed instructions for setup and building are located in the Release Note documents in each "Linux BSP" and "DRP-AI Support" package.
    • ⚠️ You must first follow the Linux BSP Release Note instructions (RZV2L_Linux_Package_version_0.8.0_Release_Note.pdf) Section 3.1 (1),(2),(3),(4)
    • Then follow DRP-AI Support Release Note (rzv2l_drpai-support-package_ver0.90_release-note.pdf) Sections 3.1 and 3.2
  • A summary of the instructions located in the Release Notes are below. Simple Copy/Paste the commands.
Simple build instructions for BSP v0.8        

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

# Extract the BSP Linux package
$ mkdir rzv2l_bsp_v0.8
$ tar -xf rzv2l_bsp_v080.tar.gz -C rzv2l_bsp_v0.8
$ cd rzv2l_bsp_v0.8

# Copy/Move the 'Mali Graphics library' Zip file (RTK0EF0045Z13001ZJ-v0.51_EN.zip) under the BSP directory.
$ unzip RTK0EF0045Z13001ZJ-v0.51_EN.zip
$ cd RTK0EF0045Z13001ZJ-v0.51_EN/proprietary
$ ./copy_gfx_mmp.sh ../../meta-rzv
$ cd ../..

# Copy/Move the 'Codec Library' package file (RTK0EF0045Z15001ZJ_0_4_0.tar.bz2) under the BSP directory.
$ tar -xvf RTK0EF0045Z15001ZJ_0_4_0.tar.bz2
$ cd meta-rzv
$ sh docs/template/copyscript/copy_proprietary_software_omx.sh  ../RTK0EF0045Z15001ZJ_0_4_0
$ cd ../

# Set up Yocto Environment
$ source poky/oe-init-build-env
$ cp ../meta-rzv/docs/template/conf/smarc-rzv2l/*.conf ./conf/

# Build
$ bitbake core-image-weston
$ bitbake core-image-weston -c populate_sdk

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
SW1-1 = ON/OFF(JTAG)                          SW1-1 = ON/OFF(JTAG)
SW1-2 = ON                                    SW1-2 = OFF
      +-----+                                       +-----+
      | ON  |                                       | ON  |
      | = = |                                       | =   |
      |     |                                       |   = |
      | 1 2 |                                       | 1 2 |
      +-----+                                       +-----+

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_boot_carrier1 'mmc dev 1 ; fatload mmc 1:1 0x48080000 Image ; fatload mmc 1:1 0x48000000 /r9a07g054l2-smarc.dtb'
=> setenv sd_boot_carrier2 'setenv bootargs 'root=/dev/mmcblk1p2 rootwait' ; booti 0x48080000 - 0x48000000'
=> setenv bootcmd 'run sd_boot_carrier1 sd_boot_carrier2'
=> saveenv

   # Reset the board and it will automatically boot

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

  • 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)

  • 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)