1. Overview

This application note explains how to install the images built by the Emcraft software distribution procedure to the Renesas RZ/V2H target.

2. Installation Workflows

2.1. Setting Up Host for Installation

The following tool are list defines system requirements for the development host, as well as tools required to be installed on the host for performing the target programming procedure:

• Ubuntu 20, 64 bit version.

• 100 GB of free space.

• A serial terminal emulator application with the “ASCII Send” capability (eg TeraTerm, picocom, etc.).

• zstd (de)compression tool.

• unzip decompression tool.

...

[user@localhost ~] unzip 0.0.1-34-12150405-rzv2h.zip
[user@localhost ~] ls -l
image-ubuntu-desktop-rzv2h-evk-alpha-emc.wic.zst                                                                                                                                                                                      
image-ubuntu-desktop-rzv2h-evk-alpha-emc.manifest                                                                                                                                                                                     
Flash_Writer_SCIF_RZV2H_DEV_INTERNAL_MEMORY.mot                                                                                                                                                                
bl2_bp_spi-rzv2h-evk-alpha-emc.srec                                                                                                                                                                                       
fip-rzv2h-evk-alpha-emc.srec         

2.2. Installing U-Boot Images to the

...

QSPI Flash

The target makes use of the U-Boot firmware as the primary OS boot loader. The U-Boot firmware boots from the QSPI Flash. Once booted, U-Boot is able to extract the OS (Linux) images from various boot media and proceed with booting Linux.

Use the following step-wise procedure to install the U-Boot images to the Renesas RZ/V2H target:

1. Power off the target board.

2. On the target CPU Module, set the SW1.4-5 switches to Off On.
   

   

3. Power on the target board.

4. In the TeraTerm window, observe the Download Mode messages, as follows:

   Code Block
   SCI Download mode (Normal SCI boot) -- Load program to SRAM ----------------

5. In the TeraTerm window, select the Send file… command and use it open the Flash_Writer_SCIF_RZV2H_DEV_INTERNAL_MEMORY.mot image.
   Note: When programming on Linux, use the ascii-xfr -s -vv command to send the files, eg:

   Code Block
   $ picocom -b 115200 /dev/ttyUSB0 -l --send-cmd="ascii-xfr -s -vv"

6. After loading the image, you should have the following prompt in the serial console window:

   Code Block
   Flash writer for RZ/V2H Series V0.60 Jan.26,2023 Product Code : RZ/V2H >

7. Enter the XLS2 command:

   Code Block
   Flash writer for RZ/V2H Series V0.60 Jan.26,2023 Product Code : RZ/V2H >XLS2

8. Enter the Program Top address and QSPI Save address as below:

   Code Block
   Flash writer for RZ/V2H Series V0.60 Jan.26,2023 Product Code : RZ/V2H >XLS2 ==== Qspi writing of RZ/G2 Board Command ============= Load Program to Spiflash Writes to any of SPI address. Program size & Qspi Save Address ===== Please Input Program Top Address ============ Please Input : H'8101E00 ===== Please Input Qspi Save Address === Please Input : H’0000 please send ! ('.' & CR stop load)

9. In the TeraTerm window, run the Send file… command on the bl2_bp_spi-rzv2h-evk-alpha-emc.srec image.

10. Repeat the loading for the fip-rzv2h-evk-alpha-emc.srec image using the Program Top address and QSPI Save address as below:

    Code Block
    Flash writer for RZ/V2H Series V0.60 Jan.26,2023 Product Code : RZ/V2H >XLS2 ===== Qspi writing of RZ/G2 Board Command ============= Load Program to Spiflash Writes to any of SPI address. Program size & Qspi Save Address ===== Please Input Program Top Address ============ Please Input : H’0000 ===== Please Input Qspi Save Address === Please Input : H’64000 please send ! ('.' & CR stop load)

11. After sending the images, turn the target board off.

12. On the target CPU Module, change the SW1.4-5 switches to Off Off.

13. Power on the target board.

14. Verify the that U-Boot messages are printed, as follows:

    Code Block

    NOTICE: BL2: v2.7(release):V2.7/RZV2H-1.00-BETA-97-g72de1727b NOTICE: BL2: Built : 07:40:32, Jun 8 2023 NOTICE: BL2: Booting BL31 NOTICE: BL31: v2.7(release):V2.7/RZV2H-1.00-BETA-97-g72de1727b NOTICE: BL31: Built : 07:40:36, Jun 8 2023 U-Boot 2021.10-g444ac845c0 (Jun 07 2023 - 20:16:28 +0900) CPU: Renesas Electronics CPU rev 1.0 Model: Renesas EVK Alpha based on r9a09g057h4 DRAM: 15.9 GiB MMC: mmc@15c00000: 0, mmc@15c10000: 1 Loading Environment from MMC... OK In: serial@11c01400 Out: serial@11c01400 Err: serial@11c01400 Net: Error: ethernet@15c30000 address not set. No ethernet found. Hit any key to stop autoboot: =>

...

1. =>

2.3. Installing to SD Card

One of the OS boot media supported by the Emcraft software distribution is the SD Card.

Use the following step-wise procedure to install the U-Boot images to the SD Card on the Renesas RZ/V2H EVK:

1. On the host, plug in the SD card and install image to SD card using the below commands (/dev/sda is the device name for SD card in the example below. Please change to your actual device name):

   Code Block
   psl@VL-4006:~$ zstd -dc image-ubuntu-desktop-rzv2h-evk-alpha-emc-20231123.wic.zst | sudo dd of=/dev/sda bs=8M conv=fdatasync psl@VL-4006:~$ sudo resize2fs /dev/sda2

2. Insert SD card to the RZ/V2H EVK board.

3. Power on the board.

4. Hit any key to stop at U-Boot prompt:

   Code Block
   ... U-Boot 2021.10-g444ac845c0 (Jun 07 2023 - 20:16:28 +0900) CPU: Renesas Electronics CPU rev 1.0 Model: Renesas EVK Alpha based on r9a09g057h4 DRAM: 15.9 GiB MMC: mmc@15c00000: 0, mmc@15c10000: 1 Loading Environment from MMC... OK In: serial@11c01400 Out: serial@11c01400 Err: serial@11c01400 Net: Error: ethernet@15c30000 address not set. No ethernet found. Hit any key to stop autoboot: =>

5. Select SD card as the boot source and boot the images:

   Code Block

   => setenv mmc_dev 1 => saveenv => run bootcmd ... Starting kernel ... [ 0.000000] Booting Linux on physical CPU 0x0000000000 [0x412fd050] [ 0.000000] Linux version 5.10.145-cip17-yocto-standard (oe-user@oe-host) (aarch64-poky-linux-gcc (GCC) 8.3.0, GNU ld (GNU Binutils) 2.31.1) #1 SMP PREEMPT Sat Feb 27 02:21:18 UTC 2021 [ 0.000000] Machine model: Renesas EVK Alpha based on r9a09g057h4 [ 0.000000] earlycon: scif0 at MMIO 0x0000000011c01400 (options '115200n8') ....

2.4. Verifying SD Card Installation

Use the following step-wise procedure to verify boot from the SD Card:

1. Login to the Linux shell prompt (user user, password user):

   Code Block
   Ubuntu 22.04.1 LTS rzv2hevkalpha ttySC0 BSP: RZV2H/RZV2H_EVK_ALPHA/0.8.0 LSI: RZV2H Version: 0.8.0 rzv2hevkalpha login: user Password: Welcome to Ubuntu 22.04.1 LTS (GNU/Linux 5.10.145-cip17-yocto-standard aarch64) ...

2. Check that SD card (/dev/mmcblk1p2) is used as the root device:

   Code Block
   user@rzv2hevkalpha:~$ cat /proc/cmdline rw rootwait earlycon root=/dev/mmcblk1p2

...

1. earlycon root=/dev/mmcblk1p2

2.5. Installing to eMMC

Another OS boot media supported by the Emcraft software distribution is the SD Card.

Use the following step-wise procedure to install the U-Boot images to the eMMC disk on the Renesas RZ/V2H EVK:

1. Boot the board from SD card (see above).

2. Note the board IP address (192.168.0.204):

   Code Block

   root@rzv2hevkalpha:~$ ifconfig eth0 eth0 Link encap:Ethernet HWaddr 12:25:99:0E:D7:97 inet addr:192.168.0.204 Bcast:192.168.0.255 Mask:255.255.255.0 inet6 addr: fe80::1025:99ff:fe0e:d797/64 Scope:Link UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:796 errors:0 dropped:11 overruns:0 frame:0 TX packets:59 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:300897 (293.8 KiB) TX bytes:8794 (8.5 KiB) Interrupt:158 root@rzv2hevkalpha:~$

3. Give the default user account rights to write block devices:

   Code Block
   root@rzv2hevkalpha:~$ sudo usermod -aG disk user

4. On the host, copy images to the board:

   Code Block
   psl@VL-4006:~$ zstd -dc image-ubuntu-desktop-rzv2h-evk-alpha-emc.wic.zst | ssh user@192.168.0.204 'dd of=/dev/mmcblk0 bs=64M conv=fdatasync' psl@VL-4006:~$ ssh user@192.168.0.204 '/bin/sync && /sbin/resize2fs /dev/mmcblk0p2' ...

5. Reboot the board and stop at U-Boot prompt:

   Code Block
   ... U-Boot 2021.10-g444ac845c0 (Jun 07 2023 - 20:16:28 +0900) CPU: Renesas Electronics CPU rev 1.0 Model: Renesas EVK Alpha based on r9a09g057h4 DRAM: 15.9 GiB MMC: mmc@15c00000: 0, mmc@15c10000: 1 Loading Environment from MMC... OK In: serial@11c01400 Out: serial@11c01400 Err: serial@11c01400 Net: Error: ethernet@15c30000 address not set. No ethernet found. Hit any key to stop autoboot: =>

6. Select eMMC as the boot source and boot the images:

   Code Block

   => setenv mmc_dev 0 => saveenv => run bootcmd ... Starting kernel ... [ 0.000000] Booting Linux on physical CPU 0x0000000000 [0x412fd050] [ 0.000000] Linux version 5.10.145-cip17-yocto-standard (oe-user@oe-host) (aarch64-poky-linux-gcc (GCC) 8.3.0, GNU ld (GNU Binutils) 2.31.1) #1 SMP PREEMPT Sat Feb 27 02:21:18 UTC 2021 [ 0.000000] Machine model: Renesas EVK Alpha based on r9a09g057h4 [ 0.000000] earlycon: scif0 at MMIO 0x0000000011c01400 (options '115200n8') ....

2.6. Verifying eMMC Installation

Use the following step-wise procedure to verify boot from the eMMC disk:

1. Login to the Linux shell prompt (user user, password user):

   Code Block
   Ubuntu 22.04.1 LTS rzv2hevkalpha ttySC0 BSP: RZV2H/RZV2H_EVK_ALPHA/0.8.0 LSI: RZV2H Version: 0.8.0 rzv2hevkalpha login: user Password: Welcome to Ubuntu 22.04.1 LTS (GNU/Linux 5.10.145-cip17-yocto-standard aarch64) ... user@rzv2hevkalpha:~$

2. Check that eMMC (/dev/mmcblk0p2) is used as the root device:

   Code Block
   user@rzv2hevkalpha:~$ cat /proc/cmdline rw rootwait earlycon root=/dev/mmcblk0p2 user@rzv2hevkalpha:~$