RZ/V2H EVK Getting Started

This page explains how to start-up the AI SDK on the RZ/V2H Evaluation Board Kit.

Supported version: RZ/V2H AI SDK v5.00

Terminology

Getting Started Flow

This page explains RZ/V2H EVK dependent instructions.
Common instructions are explained in Getting Started page.

Introduction

Prerequisites

Before reading this document, users are required to read Getting Started.
Getting Started What kind of equipment is necessary?
How can I get RZ/V AI SDK?
How can I setup RZ/V AI SDK?
How can I build AI Applications source code?

RZ/V2H EVK

The RZ/V2H EVK is the ideal board kit for RZ/V2H evaluation.

MIPI camera module is not included in EVK.
As an input device, AI Applications support USB camera with VGA (640x480) resolution.
To use MIPI camera, please refer to e-CAM22_CURZH camera provided by e-con Systems.
e-CAM22_CURZH camera supports FHD (1920x1080) resolution.

Following items are included in the RZ/V2H EVK.

Equipment	Details
RZ/V2H Evaluation Board	Evaluation board itself.

Step 7: Deploy AI Application

This section explains how to deploy the AI Application to the RZ/V2H EVK.

Before reading this step Users are required to read Step 1~6 of Getting Started.
Getting Started Step 1~6 What kind of equipment is necessary?
Where to get RZ/V AI SDK?
How can I setup RZ/V AI SDK?
How can I build AI Applications source code?

To boot the board, bootloader and other Linux necessary files are required.
Following bootloader is available on RZ/V2H AI SDK.

• eSD Bootloader: The board boots up using the bootloader written on microSD card.

Other necessary files, i.e. Linux kernel and root filesystem, are stored on microSD card.
You can use Linux PC to format the microSD card and expand the kernel and the root filesystem using SD card reader.

Note Regarding the eSD (Embedded SD) booting, please note the following:

• The eSD boot procedure using microSD card described in this guide is for evaluation purposes only.
• If you use the eSD boot, please implement the eSD on your board according to the standard "SD Specification Part 1 eSD Addendum (version 2.10)".
• The reboot command cannot be used when using the eSD boot procedure using microSD card described in this guide.

1. Setup RZ/V2H EVK

microSD card needs to contain bootloaders, the Linux kernel and root filesystem to boot-up the board.
RZ/V2H AI SDK supports the WIC format for SD card image.
You can use Linux PC to write the SD card image into microSD card with SD card reader.

Note This step is required only when starting the AI SDK or when using the new version of AI SDK.
If you have already setup the microSD card with the latest bootloader, Linux kernel, Linux device tree file and root filesystem, skip this step and proceed to the next procedure (2. Deploy Application to the Board).

Note The size of WIC format SD card image is 16GB.
If you would like to expand the SD card image size, please build the RZ/V2H AI SDK Source Code according to How to Build RZ/V2H AI SDK.

Install Necessary Software


As explained in Necessary Software of Getting Started Step 2, make sure that bmap-tools is installed on Linux PC.
If you have not installed the bmap-tools, install it using following command on Host PC (Not in the docker container).


sudo apt install bmap-tools




Write the Linux files to SD card

Run the below command to decompress ${WORK}/board_setup/eSD.zip.


cd ${WORK}/board_setup
unzip eSD.zip

Following files are necessary.
They are in the ${WORK}/board_setup/eSD directory.



File	Description
core-image-weston-rzv2h-evk-ver1.wic.bmap	SD card image
core-image-weston-rzv2h-evk-ver1.wic.gz

Follow the instruction below to prepare the microSD card.

1. Before inserting the microSD card to your Linux PC, open the terinal on Linux PC and run the following command to check the devices without microSD card.
   

   lsblk

   Following is the example output.
   

   NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
   sda 8:0 0 30.9G 0 disk
   ├─sda1 8:1 0 512M 0 part /boot/efi
   ├─sda2 8:2 0 1K 0 part
   └─sda5 8:5 0 30.3G 0 part /
   sr0 11:0 1 1024M 0 rom



2. Insert the microSD card to your Linux PC and run the following command again.
   

   lsblk



3. Check the output and confirm the name appeared. This would be your microSD card device name.
   
   • Following is the example output.
     

     NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
     sda 8:0 0 30.9G 0 disk
     ├─sda1 8:1 0 512M 0 part /boot/efi
     ├─sda2 8:2 0 1K 0 part
     └─sda5 8:5 0 30.3G 0 part /
     sdb 8:16 1 29.7G 0 disk
     └─sdb1 8:17 1 29.7G 0 part
     sr0 11:0 1 1024M 0 rom

   
   
   • In this case, followings are your microSD card configuration.
     • /dev/sdb: The device name for the entire microSD card.
     • /dev/sdb1: The paritition name in microSD card. There may be multiple sdb* depending on the microSD card.
     Warning Be careful not to use the name of other device since it may destruct your computer filesystem.


4. To use bmaptools, microSD card partitions must be unmounted.
   Run the following command to check the automatically mounted microSD card partitions.
   

   df -h

5. Check the output and find the mount point, which is "/media/user/9016-4EF8" in the following example.

   Filesystem      Size  Used Avail Use% Mounted on
   :
   snip
   :
   /dev/sdb1        15G   32K   15G   1% /media/user/9016-4EF8

   Warning Here, we use "/dev/sdb" as microSD card device name.
6. Unmount the automatically mounted partitions.

   sudo umount /media/user/9016-4EF8

   Note If there are more than one partitions on microSD card, unmount all partitions.
7. Run the following command to write SD card image.
   

   cd ${WORK}/board_setup/eSD
   sudo bmaptool copy --bmap core-image-weston-rzv2h-evk-ver1.wic.bmap core-image-weston-rzv2h-evk-ver1.wic.gz /dev/sdb

   Warning Change /dev/sdb to your microSD card device name.
   
8. Eject microSD card and insert it again to mount the partitions.
   
   
9. Run the following command to check two partitions are created on microSD card.
   

   df -h

   • If the command shows following log, two partitions are created on microSD card successfully.
     

     Filesystem      Size  Used Avail Use% Mounted on
     :
     snip
     :
     /dev/sdb1        17M  3.0M   14M  18% /media/user/bootloaderf
     /dev/sdb2        13G  1.6G   11G  14% /media/user/root

     Warning Here, we use "/dev/sdb" as microSD card device name.
10. Run the following commands to setup the partition 2, which is the root filesystem of the board.
    

    sudo mkdir /mnt/sd -p
    sudo mount /dev/sdb2 /mnt/sd
    sudo cp $WORK/ai_sdk_setup/data/libtvm_runtime.so /mnt/sd/usr/lib64
    sync
    sudo umount /mnt/sd

    Warning Change /dev/sdb to your microSD card device name.
    
    Note If you would like to eject the microSD card, please run following command and remove the microSD card from Linux PC.
    

    sudo eject /dev/sdb

    Warning Change /dev/sdb to your microSD card device name.
    

2. Deploy Application to the Board

This section explains how to copy the application binary created in Getting Started Step 6 to the board.
Users are expected to have finished the instructions in Setup RZ/V2H EVK in Step 7-1.

1. Insert the microSD card to Linux PC.


2. Run the following command to mount the partition 2, which contains the root filesystem.
   

   sudo mount /dev/sdb2 /mnt/sd

   Warning Change /dev/sdb to your microSD card device name.
   
3. Create the application directory on root filesystem.

   sudo mkdir /mnt/sd/home/root/tvm

   Note Directory name tvm can be determined by user.
   
4. Copy the necessary files in execution environment.
   Check the README.md document provided in application directory and follow the instruction in the chapter called "Application: Deploy Stage" (or similar) to deploy the application.
   
   
   Example:
   In R01_object_detection application, follow the instruction in here to find files to be copied.
   
   Use the following command to copy the files to root filesystem.
   
   

   sudo cp $WORK/ai_sdk_setup/data/<Path to target file>/<filename> /mnt/sd/home/root/tvm 

   
   
5. Run the following command to sync the data with memory.
   

   sync 

6. Run the following command to unmount the partition 2.
   

   sudo umount /mnt/sd

7. Eject the microSD card by running the following command and remove the microSD card from Linux PC.
   

   sudo eject /dev/sdb

   Warning Change /dev/sdb to your microSD card device name.
   

3. Boot RZ/V2H EVK

This section explains how to boot the RZ/V2H EVK.

Follow the instruction below to boot the board.

1. Insert the microSD card to the Board.
   Note Use the microSD card slot SD1 on the Board as shown in the figure.


2. Change DSW1 and DSW2 setting as shown in the figure.


3. Connect the USB mouse and USB keyboard and USB camera via USB hub.
   
   Note There are USB 2.0 port and USB 3.0 port on RZ/V2H EVK.
   Please connect your USB camera to appropriate port according to its requirement.
   Here, USB camera is connected to USB 2.0 via USB hub.
   


4. Connect the HDMI monitor to the Board.


5. Connect the power cable to the Board.


6. Turn the SW3 to ON.


7. Turn the SW2 to ON to power on the Board

8. After the boot-up, following screen will be displayed on HDMI monitor.

9. Click the icon at the top-left corner to open the terminal.

After the boot up, please go back to Getting Started Step 8 or proceed directly to RZ/V2H EVK Getting Started Step 8.

Step 8: Run AI Application

Before reading this step Users are required to read Step 7 of RZ/V2H EVK Getting Started.
RZ/V2H EVK Getting Started Step 7 How can I setup microSD card for eSD Bootloader?
How can I deploy applications to the board?
How can I boot the board?

1. Follow the instructions explained in the document (README.md) of applications on GitHub.
   
   
   Example:
   For R01_object_detection application, follow the instruction here to run the application.
   If you have successfully run the application, you will see following window on HDMI screen.
   
   
   
   

Note To shutdown the board safely, please refer to A4. Shutdown RZ/V2H EVK

This is the end of RZ/V2H EVK Getting Started.

To see what comes next, please refer to the Getting Started Ending.
Getting Started Ending What is the next step of Getting Started?

Back to Top >