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

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

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

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:

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

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

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

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:

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

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