Overview

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

Installation Workflows

Setting Up Host for Installation

The following tool are required to be installed on the host for performing the target programming procedure:

A serial terminal emulator application with the “ASCII Send” capability (eg TeraTerm, picocom, etc.).
zstd (de)compression tool.
unzip decompression tool.

Extract the release archive to a separate directory on the host. The files from the archive will be used in follow up sections:

[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

Installing U-Boot Images to the Board’s QSPI Flash

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

Power off the target board.
On the target CPU Module, set the SW1.4-5 switches to Off On.
Power on the target board.

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

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

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:
```
$ picocom -b 115200 /dev/ttyUSB0 -l --send-cmd="ascii-xfr -s -vv"
```
After loading the image, you should have the following prompt in the serial console window:
```
Flash writer for RZ/V2H Series V0.60 Jan.26,2023
Product Code : RZ/V2H
>
```

Enter the XLS2 command:

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

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

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)

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

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

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)

After sending the images, turn the target board off.
On the target CPU Module, change the SW1.4-5 switches to Off Off.
Power on the target board.

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

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:
=>

Installing to SD Card

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):
```
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
```
Insert SD card to the RZ/V2H EVK board.
Power on the board.

Hit any key to stop at U-Boot prompt:

...
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:
=>

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

=> 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')
....

Verifying SD Card Installation

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

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

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

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

Installing to eMMC

Boot the board from SD card (see above).

Note the board IP address (192.168.0.204):

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:~$

Give the default user account rights to write block devices:
```
root@rzv2hevkalpha:~$ sudo usermod -aG disk user
```

On the host, copy images to the board:

 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'
 ...

Reboot the board and stop at U-Boot prompt:

...
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:
=>

Select eMMC as the boot source and boot the images:

=> 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')
....

Verifying eMMC Installation