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:

  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:

    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:

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

  7. Enter the XLS2 command:

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

  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:

  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:

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

  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:

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

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

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

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

  2. Note the board IP address (192.168.0.204):

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

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

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

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

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

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