Installing Images to the Target
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 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
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:
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 theFlash_Writer_SCIF_RZV2H_DEV_INTERNAL_MEMORY.mot
image.
Note: When programming on Linux, use theascii-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:
Enter the
XLS2
command:Enter the
Program Top
address andQSPI Save
address as below:In the
TeraTerm
window, run the Send file… command on thebl2_bp_spi-rzv2h-evk-alpha-emc.srec
image.Repeat the loading for the
fip-rzv2h-evk-alpha-emc.srec
image using theProgram Top
address andQSPI Save
address as below: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:
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:
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):Insert SD card to the RZ/V2H EVK board.
Power on the board.
Hit any key to stop at U-Boot prompt:
Select SD card as the boot source and boot the images:
2.4. 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
, passworduser
):Check that SD card (
/dev/mmcblk1p2
) is used as the root device:
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:
Boot the board from SD card (see above).
Note the board IP address (192.168.0.204):
Give the default user account rights to write block devices:
On the host, copy images to the board:
Reboot the board and stop at U-Boot prompt:
Select eMMC as the boot source and boot the images:
2.6. Verifying eMMC Installation
Use the following step-wise procedure to verify boot from the eMMC disk:
Login to the Linux shell prompt (user
user
, passworduser
):Check that eMMC (
/dev/mmcblk0p2
) is used as the root device: