diff --git a/docs/_site/404.html b/docs/_site/404.html index 00e8638..ed8a097 100755 --- a/docs/_site/404.html +++ b/docs/_site/404.html @@ -33,7 +33,7 @@ {"@context":"https://schema.org","@type":"WebPage","dateModified":"2023-04-20T11:18:09+09:00","description":"The best solution for starting your AI applications.","headline":"Renesas RZ/V AI","url":"https://renesas-rz.github.io/rzv_ai_sdk/2.10/404.html"} - + diff --git a/docs/_site/RZV2L_board_setup_e2studio.html b/docs/_site/RZV2L_board_setup_e2studio.html index 48d7d73..cd68759 100755 --- a/docs/_site/RZV2L_board_setup_e2studio.html +++ b/docs/_site/RZV2L_board_setup_e2studio.html @@ -33,7 +33,7 @@ {"@context":"https://schema.org","@type":"WebPage","dateModified":"2023-12-11T19:09:38+09:00","description":"The best solution for starting your AI applications.","headline":"Renesas RZ/V AI","url":"https://renesas-rz.github.io/rzv_ai_sdk/2.10/RZV2L_board_setup_e2studio.html"} - + diff --git a/docs/_site/ai-sdk.html b/docs/_site/ai-sdk.html index 34f9401..2789fa9 100755 --- a/docs/_site/ai-sdk.html +++ b/docs/_site/ai-sdk.html @@ -30,10 +30,10 @@ +{"@context":"https://schema.org","@type":"WebPage","dateModified":"2024-01-26T14:34:19+09:00","description":"The best solution for starting your AI applications.","headline":"Renesas RZ/V AI","url":"https://renesas-rz.github.io/rzv_ai_sdk/2.10/ai-sdk.html"} - + diff --git a/docs/_site/appendix.html b/docs/_site/appendix.html index 6521136..e8f7969 100755 --- a/docs/_site/appendix.html +++ b/docs/_site/appendix.html @@ -33,7 +33,7 @@ {"@context":"https://schema.org","@type":"WebPage","dateModified":"2023-12-11T19:09:38+09:00","description":"The best solution for starting your AI applications.","headline":"Renesas RZ/V AI","url":"https://renesas-rz.github.io/rzv_ai_sdk/2.10/appendix.html"} - + diff --git a/docs/_site/appendix_internal.html b/docs/_site/appendix_internal.html new file mode 100644 index 0000000..cef0b91 --- /dev/null +++ b/docs/_site/appendix_internal.html @@ -0,0 +1,1275 @@ + + + + + + + + + + + + + +Renesas RZ/V AI | The best solution for starting your AI applications. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ + +

Renesas
RZ/V AI

+

2.10

+ + + +

The best solution for
starting your AI applications.

+

Provided by Renesas Electronics Corporation

+
+ + + + + +
+
+
+ board + +
+
+ ai_sdk + +
+
+
+ + + +

+

+ To keep you updated,
Watch our GitHub repository
+
+ Watch +

+ + +
+ + + +
+
+
+
+ +

This project is maintained by renesas-rz

+ +

Hosted on GitHub Pages — Theme by orderedlist

+
+
+
+ + + + + +
+
+
+Getting Started Appendix +
+
+
+
+ WARNING + + + This page is published for Renesas internal purpose only.
+ Do NOT distribute/share this page to external parties.
+ Since this page is still under the review process, the content may change in the official release.
+
+ Due to the necessary software unavailability (i.e., DRP-AI TVM, AI Applications),
+ you can only run following steps with this internal release. +
    +
  • + Step 2: Obtain necessary environment +
  • +
  • + Step 4: Extract RZ/V AI SDK package +
  • +
  • + Step 7: Deploy AI Application. +
      +
    • + 1. Setup RZ/V2H EVK +
    • +
    • + 3. Boot RZ/V2H EVK +
    • +
    +
  • +
  • + A4. Shutdown RZ/V2H EVK +
  • +
+
+
+
+


+

+
This page explains the additional information of Getting Started.
+ +

A1. Setup for eMMC Bootloader

+

This section explains how to setup the board for eMMC Bootloader. +

+
+ 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 and the bootloader written in eMMC on the board, skip this step and proceed to the next step (Step7:2. Deploy Application to the Board in Getting Started). +
+ +

Follow the instruction below to setup the board.

+
+ Note + Explanation in this step is for eMMC Bootloader, which requires Windows PC as serial communication console.
+
+ +


+After this procedure, you can copy the AI Application and boot the board.
+Refer to the Step 7: 2. Deploy Application to the Board in RZ/V2L EVK Getting Started (Link not available). +

+ +

A2. Format SD card

+

When writing the necessary files for the board, microSD card needs to have appropriate format.
+ Note that you need to run this procedure only once as long as you use the same microSD card. +

+ Follow the instruction below to format the microSD card partitions.

+
Preparation
+
+ Click the button + This section contains both eSD and eMMC Bootloader explanation.
+ Please click the button below to update the explanation according to your bootloader interface.
+
+ eSD Bootloader + eMMC Bootloader +
+
+ For eSD + eSD explanation will be shown in this style if you click "eSD Bootloader" button above. +
+
+ For eMMC + eMMC explanation will be shown in this style if you click "eMMC Bootloader" button above. +
+
+


+
Check the SD card connection
+
    +
  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. +
  3. Insert the microSD card to your Linux PC and run the following command again. + +
    lsblk
    + +

  4. +
  5. 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. +
      +
    • +
    +

  6. +
  7. Run the following command to check the automatically mounted microSD card partitions. + +
    df
    + +

  8. +
  9. Check the output and find the mount point, which is "/media/user/A8D3-393D" in the following example. + +
    Filesystem 1K-blocks Used Available Use% Mounted on
    +udev 745652 0 745652 0% /dev
    +:
    +snip
    +:
    +/dev/sdb1 511720 4904 506816 1% /media/user/A8D3-393B
    + +

  10. +
  11. Unmount the automatically mounted partitions. + +
    sudo umount /media/user/A8D3-393B
    + +
    • + If there are more than one partitions on microSD card, unmount all partitions. +
    +
  12. +
+


+
Create SD card partition
+
    +
  1. + Run fdisk command as shown below to change the partition table according to the following table. +
    +
    + For eSD + + + + + + + + + + + + + + + + + + + +
    Type/NumberSizeType of FilesystemContents
    Primary #1500MB (minimum 128MB)Ext4Linux kernel
    Device tree
    Primary #2All remainingExt4Root filesystem
    +
    + Note + "Type of Filesystem" of "Primary #1 Linux kernel and Device tree" Contents is Ext4.
    +
    +
    +
    + For eMMC + + + + + + + + + + + + + + + + + + + +
    Type/NumberSizeType of FilesystemContents
    Primary #1500MB (minimum 128MB)FAT32Linux kernel
    Device tree
    Primary #2All remainingExt4Root filesystem
    +
    + Note + "Type of Filesystem" of "Primary #1 Linux kernel and Device tree" Contents is FAT32.
    +
    +
    +
    + +
    sudo fdisk /dev/sdb
    + +
    + Warning + Use device name. Do NOT use partition name such as /dev/sdb1. +
    +
      +
    • Following log will be shown. + +
      Welcome to fdisk (util-linux 2.34).
      +Changes will remain in memory only, until you decide to write them.
      +Be careful before using the write command.
      +
      +Command (m for help):
      + +

    • +
    • Type "o" to console. The log continues. + +
      Created a new DOS disklabel with disk identifier 0x6b6aac6e.
      +
      +Command (m for help):
      + +

    • +
    • Type "n" to console. The log continues. + +
      Partition type
      +p primary (0 primary, 0 extended, 4 free)
      +e extended (container for logical partitions)
      +Select (default p):
      + +

    • +
    • Type "p" to console. The log continues. + +
      Partition number (1-4, default 1):
      + +

    • +
    • Press ENTER key. The log continues. + +
      First sector (2048-62333951, default 2048):
      + +

    • +
    • Press ENTER key. The log continues. + +
      Last sector, +/-sectors or +/-size{K,M,G,T,P} (2048-62333951,
      +default 62333951):
      + +

    • +
    • Type "+500M" to console. The log continues. + +
      Created a new partition 1 of type 'Linux' and of size 500 MiB.
      +Partition #1 contains a vfat signature.
      +
      +Do you want to remove the signature? [Y]es/[N]o:
      + +

    • +
    • Type "Y" to console. The log continues. + +
      The signature will be removed by a write command.
      +
      +Command (m for help):
      + +

    • +
    • Type "n" to console. The log continues. + +
      Partition type
      +p primary (1 primary, 0 extended, 3 free)
      +e extended (container for logical partitions)
      +Select (default p):
      + +

    • +
    • Type "p" to console. The log continues. + +
      Partition number (2-4, default 2):
      + +

    • +
    • Press ENTER key. The log continues. + +
      First sector (1026048-62333951, default 1026048):
      + +

    • +
    • Press ENTER key. The log continues. + +
      Last sector, +/-sectors or +/-size{K,M,G,T,P} (1026048-62333951,
      +default 62333951):
      + +

    • +
    • Press ENTER key. The log continues. + +
      Created a new partition 2 of type 'Linux' and of size 29.2 GiB.
      +
      +Command (m for help):
      + +

    • +
    • Type "p" to console. The log continues. + +
      Disk /dev/sdb: 29.74 GiB, 31914983424 bytes, 62333952 sectors
      +Disk model: Transcend
      +Units: sectors of 1 \* 512 = 512 bytes
      +Sector size (logical/physical): 512 bytes / 512 bytes
      +I/O size (minimum/optimal): 512 bytes / 512 bytes  
      + Disklabel type: dos
      +Disk identifier: 0x6b6aac6e
      +
      +Device Boot Start End Sectors Size Id Type
      +/dev/sdb1 2048 1026047 1024000 500M 83 Linux
      +/dev/sdb2 1026048 62333951 61307904 29.2G 83 Linux
      +
      +Filesystem/RAID signature on partition 1 will be wiped.
      +
      +Command (m for help):
      + +
    • +
      + For eMMC + Additionally, run the following procedures to set the partition as FAT32. +
        +
      • Type "t" to console. The log continues. + +
        Partition number (1,2, default 2):
        + +

      • +
      • Type "1" to console. The log continues. + +
        Hex code (type L to list all codes):
        + +

      • +
      • Type "b" to console. The log continues. + +
        Changed type of partition 'Linux' to 'W95 FAT32'.
        +
        +Command (m for help):
        + +
      • +
      +
      +
      +
    • Type "w" to console. The fdisk interface will end. + +
      The partition table has been altered.
      +Syncing disks.
      + +
    • +
    +

  2. +
  3. Check the partition table with the command below. + +
    partprobe
    +sudo fdisk -l /dev/sdb
    + +
    • Output would be as follows. Note that there are two partitions. +
      + For eSD + +
      Disk /dev/sdb: 29.74 GiB, 31914983424 bytes, 62333952 sectors
      +Disk model: Maker name etc.
      +Units: sectors of 1 * 512 = 512 bytes
      +Sector size (logical/physical): 512 bytes / 512 bytes
      +I/O size (minimum/optimal): 512 bytes / 512 bytes
      +Disklabel type: dos
      +Disk identifier: 0x6b6aac6e
      +Device Boot Start End Sectors Size Id Type
      +/dev/sdb1 2048 1026047 1024000 500M 83 Linux 
      +/dev/sdb2 1026048 62333951 61307904 29.2G 83 Linux
      + +
      +
      + For eMMC + +
      Disk /dev/sdb: 29.74 GiB, 31914983424 bytes, 62333952 sectors
      +Disk model: Maker name etc.
      +Units: sectors of 1 * 512 = 512 bytes
      +Sector size (logical/physical): 512 bytes / 512 bytes
      +I/O size (minimum/optimal): 512 bytes / 512 bytes
      +Disklabel type: dos
      +Disk identifier: 0x6b6aac6e
      +Device Boot Start End Sectors Size Id Type
      +/dev/sdb1 2048 1026047 1024000 500M b W95 FAT32
      +/dev/sdb2 1026048 62333951 61307904 29.2G 83 Linux
      + +
      +
    +

  4. +
  5. Run the command below to format and mount the partitions 1. +
    + Note + If the partitions were automatically mounted after the procedure 6 of "Check the SD card connection", please unmount them again. +
    +
    + For eSD + +
    sudo mkfs.ext4 -L boot /dev/sdb1
    + +
    • Following log will be shown. + +
      mke2fs 1.45.5 (07-Jan-2020)
      +Creating filesystem with 128000 4k blocks and 128000 inodes
      +Filesystem UUID: 0d2b995c-dd96-4ff6-953c-66a4701fa034
      +Superblock backups stored on blocks:
      +  32768, 98304
      +Allocating group tables: done
      +Writing inode tables: done
      +Creating journal (4096 blocks): done
      +Writing superblocks and filesystem accounting information: done
      + +
    +
    +
    + For eMMC + +
    sudo mkfs.vfat -v -c -F 32 /dev/sdb1
    + +
    • Following log will be shown. + +
      mkfs.fat 4.1 (2017-01-24)
      +/dev/sdb1 has 64 heads and 32 sectors per track,
      +hidden sectors 0x0800;
      +logical sector size is 512,
      +using 0xf8 media descriptor, with 1024000 sectors;
      +drive number 0x80;
      +filesystem has 2 32-bit FATs and 8 sectors per cluster.
      +FAT size is 1000 sectors, and provides 127746 clusters.
      +There are 32 reserved sectors.
      +Volume ID is a299e6a6, no volume label.
      +Searching for bad blocks 16848... 34256... 51152... 68304... 85072... 10209
      +6... 119376... 136528... 153552... 170576... 187472... 204624... 221648... 238
      +928... 256208... 273744... 290768... 308048... 325328... 342480... 359504... 3
      +76656... 393680... 410576... 427216... 444624... 462032... 479184... 495952...
      + +
    +
    +

  6. +
  7. Run the command below to format and mount the partitions 2. + +
    sudo mkfs.ext4 -L rootfs /dev/sdb2
    + +
    • Following log will be shown. + +
      mke2fs 1.45.5 (07-Jan-2020)
      +Creating filesystem with 7663488 4k blocks and 1916928 inodes
      +Filesystem UUID: 63dddb3f-e268-4554-af51-1c6e1928d76c
      +Superblock backups stored on blocks:
      +32768, 98304, 163840, 229376, 294912, 819200, 884736, 1605632, 2654208,
      +4096000
      +Allocating group tables: done
      +Writing inode tables: done
      +Creating journal (32768 blocks): done
      +Writing superblocks and filesystem accounting information: done
      + +
    +

  8. +
  9. Eject the microSD card and insert it again to remount the partitions. +
  10. +
+


+After this procedure, you can write the necessary data for the board into microSD card.
+Refer to the Write the Linux files to SD card in RZ/V2L EVK Getting Started (Link not available).

+ +



+ +

A3. Shutdown RZ/V2L EVK

+

To power-off the RZ/V2L EVK, follow the procedures below. +

+ +
    +
  1. Run the shutdown command on board console. +
    + +
    shutdown -h now
    + +
  2. +
  3. On board console, check that shutdown procedure runs and ends with following log. +
    + +
    [xxxxx.xxxxxx] reboot: Power down
    + +
  4. +
  5. Press and hold the power button for 2 seconds. +

    + board
    +
  6. +
+
+



+

A4. Shutdown RZ/V2H EVK

+

To power-off the RZ/V2H EVK, follow the procedures below. +

+
    +
  1. Run the shutdown command on board console. +
    + +
    shutdown -h now
    + +
  2. +
  3. On board console, check that shutdown procedure runs and ends with following log. +
    + +
    [xxxxx.xxxxxx] reboot: Power down
    + +
  4. +
  5. + Turn SW2 to OFF. +

    +
  6. +
  7. + Turn SW3 to OFF. +

    + board
    +
  8. +
+



+ + + + + +
+ +
+ + + diff --git a/docs/_site/applications.html b/docs/_site/applications.html index 014b5e5..1944bbe 100755 --- a/docs/_site/applications.html +++ b/docs/_site/applications.html @@ -33,7 +33,7 @@ {"@context":"https://schema.org","@type":"WebPage","dateModified":"2023-12-11T19:09:38+09:00","description":"The best solution for starting your AI applications.","headline":"Renesas RZ/V AI","url":"https://renesas-rz.github.io/rzv_ai_sdk/2.10/applications.html"} - + diff --git a/docs/_site/assets/css/style.css b/docs/_site/assets/css/style.css index 7c25fa8..974a439 100755 --- a/docs/_site/assets/css/style.css +++ b/docs/_site/assets/css/style.css @@ -3205,10 +3205,24 @@ h3, .h3 { padding: 0.5rem 0 0.8rem; margin-bottom: 5px; border-bottom: 1px solid .top { font-size: 35px; background-color: #2a289d; color: white; display: flex; align-items: center; font-family: "Arial"; font-style: italic; padding: 20px 10px; } +.product-button { font-weight: bold; color: #676767; padding-left: 30px; padding-right: 30px; min-width: 187px; } + +.download-button-yellow { font-weight: bold; color: #676767; } + .download-button { font-weight: bold; } .square-button { font-weight: bold; font-size: medium; border-radius: 0px; background-color: #2a289d; border-color: #2a289d; } +.square-button-gray { font-weight: bold; font-size: medium; border-radius: 0px; background-color: #7c909b; border-color: #7c909b; } + +.banner-title { font-weight: bold; font-size: 1.3em; padding-right: 0.5em; } + +.banner-line-md { display: block; padding-left: 0.5em; font-weight: normal; font-size: 1.0em; } + +.banner-line { display: block; padding-left: 0.5em; font-weight: normal; font-size: 0.8em; } + +.table-small-text { font-weight: normal; font-size: 0.7em; } + .skip { color: red; font-weight: bold; } img.procedure { max-width: 400px; } @@ -3250,6 +3264,8 @@ a.applications:hover ul.applabel > li, a.applications:focus ul.applabel > li { c ul.index { list-style: none; margin: 0 0 0 0; } +.index-string { color: #267CB9; } + p.downloads { padding: 0; margin: 0 0 0 0; text-align: center; } ul.downloads { list-style: none; background: none; border: none; vertical-align: middle; width: 100%; } @@ -3313,6 +3329,8 @@ h2, .h2 { padding: 1rem 1rem; border-left: 8px solid #2a289d; color: #2a289d; ba h3, .h3 { position: relative; margin: 15px 0px; border-bottom: 2px solid #2a289d; } +h4.u_line, .u_line.h4 { margin: 15px 5px; padding: 5px 0px; border-bottom: 1.5px solid #afafaf; } + .container { max-width: 100%; } .note { display: block; position: relative; margin: 1em 0; padding: 23px 10px 7px; max-width: fit-content; color: #000000; background: #f3f3fc; } @@ -3353,8 +3371,17 @@ code { word-wrap: normal; color: #444; background: #f0f0f0; border-radius: 3px; pre { border-radius: 5px; color: #444; background: #f0f0f0; border: solid 1px #dddddd; overflow: auto; -webkit-overflow-scrolling: touch; } +.ham-display { display: none; } + /********** Hamburger Menu **********/ -@media print, screen and (max-width: 960px) { .menu-btn { position: fixed; top: 5px; right: 5px; display: flex; height: 50px; width: 50px; justify-content: center; align-items: center; z-index: 10; background-color: #2a289d; border-radius: 5px; } +@media print, screen and (max-width: 960px) { .index-string { color: white; } + .ham-string { color: white; } + .ham-nodisplay { display: none; } + .ham-small { font-size: 12px; margin-bottom: 3px; } + .ham-very-small { font-size: 10px; margin-bottom: 3px; } + .ham-display { display: block; } + .product-button { width: auto; min-width: none; } + .menu-btn { position: fixed; top: 5px; right: 5px; display: flex; height: 50px; width: 50px; justify-content: center; align-items: center; z-index: 10; background-color: #2a289d; border-radius: 5px; } .menu-btn span, .menu-btn span:before, .menu-btn span:after { content: ''; display: block; height: 2px; width: 25px; border-radius: 3px; background-color: #ffffff; position: absolute; } .menu-btn span:before { bottom: 8px; } .menu-btn span:after { top: 8px; } @@ -3366,8 +3393,7 @@ pre { border-radius: 5px; color: #444; background: #f0f0f0; border: solid 1px #d .menu-content summary { list-style: none; font-size: 110%; margin-left: 25px; padding-top: 10px; position: relative; } .menu-content a { list-style: none; display: block; width: 100%; font-size: 110%; box-sizing: border-box; color: #ffffff; border-bottom: solid 1px #ffffff; padding: 9px 15px 5px 0; position: relative; } .menu-content a::before { content: ""; width: 7px; height: 7px; border-top: solid 2px #ffffff; border-right: solid 2px #ffffff; transform: rotate(45deg); position: absolute; right: 11px; top: 20px; } - .menu-content details:has(ul) > summary > a { border-bottom: none; pointer-events: none; } - .menu-content details:has(ul) > summary > a::before { content: none; } + .menu-content details:has(ul) > summary > a { border-bottom: none; } .menu-content details > summary::before { content: ""; width: 12px; height: 12px; border-top: solid 2px #ffffff; border-right: solid 2px #ffffff; transform: rotate(45deg); position: absolute; left: -25px; top: 26px; transition: all 0.3s; } .menu-content details[open] > summary::before { top: 25px; transform: rotate(135deg); transition: all 0.3s; } } #menu-btn-check { display: none; } @@ -3431,3 +3457,23 @@ pre { border-radius: 5px; color: #444; background: #f0f0f0; border: solid 1px #d .Perf-Framerate { margin: 5px 6px 0px 0px; font-size: 14px; text-align: center; } dl { display: flex; flex-wrap: wrap; margin: 0; } + +/****************************************************/ +@media (max-width: 991px) { #application-filter { position: fixed; top: 56px; right: 0; width: 50%; max-height: 80vh; overflow-y: auto; display: none; } + #filter-title { background-color: #706f6f; color: white; padding: 10px; position: sticky; top: 0; z-index: 1; width: 100%; } + #application-filter-body { color: white; padding-top: 0; padding: 10px; padding-bottom: 10px; background-color: #706f6f; margin-top: -15px; } + #application-filter-visible-button { display: none; position: fixed; top: 60px; right: 0px; z-index: 2; color: #000077; display: block; } + #application-filter-erase-button { position: relative; display: none; color: darkgrey; padding: 0; margin: 0px 0px 0px -30px; box-shadow: none; } + #application-filter-hide-button { position: relative; top: -80px; right: -50%; display: none; color: #2a289d; } + #category-filter-titlecolor { color: white; border-bottom-color: white; } + #filter-titlecolor { color: white; margin-bottom: 0; } } +@media (min-width: 992px) { #application-filter { position: fixed; top: 56px; right: 0; width: 200px; max-height: 80vh; overflow-y: auto; } + #filter-title { background-color: #fff; padding: 10px; position: sticky; top: 0; z-index: 1; width: 100%; } + #application-filter-body { padding-top: 0; padding: 10px; padding-bottom: 10px; margin-top: -10%; } + #application-filter-visible-button { display: none; position: fixed; top: 60px; right: 0px; z-index: 2; color: #000077; display: block; } + #application-filter-erase-button { position: relative; display: none; color: darkgrey; padding-left: 0; margin-left: -20%; margin-top: -30px; margin-bottom: -10px; box-shadow: none; } + #application-filter-erase-button :hover { color: dodgerblue; } + #application-filter-hide-button { position: relative; display: none; } } +#application-filter-button-container { position: fixed; top: 145px; right: 30px; z-index: 2; } + +.checkbox-group:hover { color: dodgerblue; } diff --git a/docs/_site/demo.html b/docs/_site/demo.html index 919ffff..f50c1ed 100755 --- a/docs/_site/demo.html +++ b/docs/_site/demo.html @@ -33,7 +33,7 @@ {"@context":"https://schema.org","@type":"WebPage","dateModified":"2023-12-11T19:09:38+09:00","description":"The best solution for starting your AI applications.","headline":"Renesas RZ/V AI","url":"https://renesas-rz.github.io/rzv_ai_sdk/2.10/demo.html"} - + diff --git a/docs/_site/eSD_format_sd.html b/docs/_site/eSD_format_sd.html index 757c355..43e4033 100755 --- a/docs/_site/eSD_format_sd.html +++ b/docs/_site/eSD_format_sd.html @@ -33,7 +33,7 @@ {"@context":"https://schema.org","@type":"WebPage","dateModified":"2023-12-11T19:09:38+09:00","description":"The best solution for starting your AI applications.","headline":"Renesas RZ/V AI","url":"https://renesas-rz.github.io/rzv_ai_sdk/2.10/eSD_format_sd.html"} - + diff --git a/docs/_site/feed.xml b/docs/_site/feed.xml index 5dc7447..e86b591 100755 --- a/docs/_site/feed.xml +++ b/docs/_site/feed.xml @@ -1 +1 @@ -Jekyll2024-01-26T14:31:49+09:00https://renesas-rz.github.io/rzv_ai_sdk/2.10/feed.xmlRenesas RZ/V AIThe best solution for starting your AI applications. \ No newline at end of file +Jekyll2024-02-22T12:51:44+09:00https://renesas-rz.github.io/rzv_ai_sdk/2.10/feed.xmlRenesas RZ/V AIThe best solution for starting your AI applications. \ No newline at end of file diff --git a/docs/_site/getting_started.html b/docs/_site/getting_started.html index bca63ca..5a6c4b3 100755 --- a/docs/_site/getting_started.html +++ b/docs/_site/getting_started.html @@ -30,10 +30,10 @@ +{"@context":"https://schema.org","@type":"WebPage","dateModified":"2024-01-26T14:34:19+09:00","description":"The best solution for starting your AI applications.","headline":"Renesas RZ/V AI","url":"https://renesas-rz.github.io/rzv_ai_sdk/2.10/getting_started.html"} - + diff --git a/docs/_site/getting_started_internal.html b/docs/_site/getting_started_internal.html new file mode 100644 index 0000000..bb04959 --- /dev/null +++ b/docs/_site/getting_started_internal.html @@ -0,0 +1,1357 @@ + + + + + + + + + + + + + +Renesas RZ/V AI | The best solution for starting your AI applications. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ + +

Renesas
RZ/V AI

+

2.10

+ + + +

The best solution for
starting your AI applications.

+

Provided by Renesas Electronics Corporation

+
+ + + + + +
+
+
+ board + +
+
+ ai_sdk + +
+
+
+ + + +

+

+ To keep you updated,
Watch our GitHub repository
+
+ Watch +

+ + +
+ + + +
+
+
+
+ +

This project is maintained by renesas-rz

+ +

Hosted on GitHub Pages — Theme by orderedlist

+
+
+
+ + + + + +
+
+
+Getting Started +
+
+
+
+ WARNING + + + This page is published for Renesas internal purpose only.
+ Do NOT distribute/share this page to external parties.
+ Since this page is still under the review process, the content may change in the official release.
+
+ Due to the necessary software unavailability (i.e., DRP-AI TVM, AI Applications),
+ you can only run following steps with this internal release. +
    +
  • + Step 2: Obtain necessary environment +
  • +
  • + Step 4: Extract RZ/V AI SDK package +
  • +
  • + Step 7: Deploy AI Application. +
      +
    • + 1. Setup RZ/V2H EVK +
    • +
    • + 3. Boot RZ/V2H EVK +
    • +
    +
  • +
  • + A4. Shutdown RZ/V2H EVK +
  • +
+
+
+
+


+

+
This page explains how to start-up the AI SDK.
+

AI SDK is build for specific board.
+Its version varies depending on the supported board.

+ + + + + + + + + + + + + +
Supported BoardSupported AI SDK
RZ/V2L Evaluation Board KitRZ/V2L AI SDK v2.10
RZ/V2H Evaluation Board KitRZ/V2H AI SDK v3.00
+

Learn more about the RZ/V series.

+ + +
+ Note + Hereafter, we use following terminology.
+
    +
  • RZ/V AI SDK: Refers both RZ/V2L AI SDK and RZ/V2H AI SDK.
  • +
  • EVK: Refers "Evaluation Board Kit".
  • +
+
+
+ +
+ Tutorial video + Tutorial video is available here.
+ Latest tutorial video is based on RZ/V2L AI SDK version 2.10.
+
+ +

Introduction

+
+
+
+

Getting Started Flow

+ Getting Started explains the instruction to run AI Applications.
+ Common instructions are explained in this document.
+ Board dependent instructions are explained in each EVK Getting Started page.
+ flow +
+
+
+
+

Software

+ Renesas provides following software. +

+ + + + + + + + + + + + + + + + + + + + + +
SoftwareProvided onDetails
AI ApplicationsGitHub + This software is a set of following files that runs on the evaluation board kit.
+
    +
  • + Application Source code (C++) +
  • +
  • + Pre-build application binary +
  • +
  • + Other necessary files to run the application +
  • +
  • + Documentation (README.md) +
  • +
+ "Getting Started" page (this page) explains how to run the AI Applications. +
RZ/V AI SDKRenesas Website + This software is a development environment for AI Applications.
+ Provided as a zip file.
+ "Getting Started" page (this page) explains how to use RZ/V AI SDK to run the AI Applications. +
RZ/V AI SDK
Source Code
Renesas Website + This software is the source code of RZ/V AI SDK.
+ Provided as a zip file.
+ It includes Yocto Linux recipe.
+ Details and instructions are explained in the following pages.
+ + + + +
+ + + + +
+
+
+
+ +

Step 1: Obtain an evaluation board

+
+
+
+ To start using RZ/V AI SDK, we need to get the board.
+ Renesas provides ideal board kit for evaluation.
+
+ Click the button below to get the board.
+ + + + +
+
+ To see the details of the board, please see EVK Getting Started.
+ + + + +
+ + + + +
+
+
+ +
+
+
+ The RZ/V2L Evaluation Board Kit (EVK) is the ideal board kit for RZ/V2L evaluation. +

+ Since MIPI camera module is included, you can start evaluating RZ/V2L immediately by building an environment. +

+ Get RZ/V2L EVK +
+
+ board +
+
+
+
+ Following items are included in the RZ/V2L Evaluation Board Kit. +

+ + + + + + + + + + + + + + + + + +
EquipmentDetails
RZ/V2L Evaluation BoardEvaluation board itself.
MIPI Camera ModuleGoogle Coral Camera.
+
Note that the CMOS sensor (OV5645) in the camera is no longer available, and should not be used for mass production.
Any software support provided is for evaluation purposes only.
MicroUSB to Serial CableFor serial communication between PC and the board.
+
+
+
+
+


+ +

Step 2: Obtain necessary environment

+

1. Necessary Equipments

+

Please prepare the following equipments for your EVK.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ForEquipmentDetails
+ RZ/V2L + + RZ/V2L EVK + + Evaluation Board Kit for RZ/V2L.
Includes followings. +
    +
  • + MIPI Camera Module(Google Coral Camera) +
    +
    + Note that the CMOS sensor (OV5645) in the camera is no longer available, and should not be used for mass production.
    + Any software support provided is for evaluation purposes only. +
    +
  • +
  • MicroUSB to Serial Cable for serial communication.
  • +
+
+ AC Adapter + + USB Power Delivery adapter for the board power supply. +
+ MicroHDMI Cable + + Used to connect the HDMI Monitor and the board.
+ RZ/V2L EVK has microHDMI port. +
+ USB Camera + + Optional. AI Applications support USB camera input.
+ Supported resolution: 640x480
+ Supported format: 'YUYV' (YUYV 4:2:2) +
+ Windows PC + + Optional. Used as the serial communication console for eMMC Bootloader.
+ Operating Environment : Windows 10 +
+ RZ/V2H + + RZ/V2H EVK + + Evaluation Board Kit for RZ/V2H. +
+ AC Adapter + + USB Power Delivery adapter for the board power supply.
+ 100W is required. +
+ HDMI Cable + + Used to connect the HDMI Monitor and the board.
+ RZ/V2H EVK has HDMI port. +
+ USB Camera + + Since RZ/V2H EVK does not include camera module, this will be the standard camera input source.
+ Supported resolution: 640x480
+ Supported format: 'YUYV' (YUYV 4:2:2)
+
+ To use MIPI camera, please refer to e-CAM22_CURZH provided by e-con Systems.
+ e-CAM22_CURZH camera supports FHD(1920x1080) resolution. +
+
+ Common + + USB Cable Type-C + + Connect AC adapter and the board. +
+ HDMI Monitor + + Used to display the graphics of the board. +
+ microSD card + + Must have over 4GB capacity of blank space.
+ Operating Environment: Transcend UHS-I microSD 300S 16GB +
+ Linux PC + + Used for Setup microSD card and RZ/V AI SDK Setup.
+ Operating Environment: Ubuntu 20.04 +
+ SD card reader + + Used for setting up microSD card. +
+ USB Hub + + Used to connect USB Keyboard and USB Mouse to the board. +
+ USB Keyboard + + Used to type strings on the terminal of board. +
+ USB Mouse + + Used to operate the mouse on the screen of board. +
+
+ Note + USB camera has different supported resolution and format.
+ To check the specification of your USB camera, use v4l2-ctl command. +
+ + In addition to the RZ/V2L Evaluation Board Kit, please prepare the following equipments.
+
+ Note + Serial to MicroUSB Cable and MIPI Camera Module (Google Coral camera) is included in RZ/V2L Evaluation Board Kit. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
EquipmentDetails
HDMI MonitorUsed to display the graphics.
Micro HDMI CableUsed to connect the HDMI Monitor and the board.
AC adapterPower supply to the board.
USB Cable Type-CConnect AC adapter and the board.
microSD cardMust have over 4GB capacity of blank space.
Operating Environment: Transcend UHS-I microSD 300S 16GB
Linux PCUsed for Setup microSD card and RZ/V2L AI SDK Setup.
+ Operating Environment: Ubuntu 20.04
SD card readerUsed for setting up microSD card.
Windows PCOptional. Used as the serial communication console for eMMC Bootloader.
+ Operating Environment : Windows 10
USB HubUsed to connect USB Keyboard and USB Mouse.
USB KeyboardUsed to type strings on the terminal of board.
USB MouseUsed to operate the mouse on the screen of board.
+
+


+

2. Necessary Software

+

Please install following software on Linux PC.

+ +


+ +

Step 3: Obtain RZ/V AI SDK

+

RZ/V AI SDK provides following packages for each supported board.

+ + + + + + + + + + + + + + + + +
NamePackageDetails
RZ/V AI SDKRTK0EF0*SJ.zipPackage used for AI development.
RZ/V AI SDK
Source Code
RTK0EF0*SJ_linux-src.zipPackage used for Linux development.
+ Please refer to following pages for more details on this package.
+ + + + +
+ + + + +
+

For this Getting Started, please download "RZ/V AI SDK" for your preferred device from the link below.
+ + + + +

+Once downloaded, please check the Release Note included in the package. +

+ +

Step 4: Extract RZ/V AI SDK package

+

This step explains how to extract the RZ/V AI SDK zip file.

+
    +
  1. On your Linux PC, make the working directory. + +
    mkdir -p ai_sdk_work
    + +
  2. +
  3. Register the working directory path to an environment variable. + +
    export WORK=<path to the working directory>/ai_sdk_work
    + +
  4. +
  5. Move to the working directory. + +
    cd ${WORK}
    + +
  6. +
  7. Extract RZ/V AI SDK zip file under the working directory. + +
    unzip <Path to the file>/RTK0EF0*.zip -d ${WORK}
    + +
  8. +
  9. Check the working directory to confirm the package contents. + +
    ls ${WORK}/
    + +
      +
    • If the above command prints followings, the package is extracted correctly. + +
      ai_sdk_setup  board_setup  documents  references r11an0*.pdf
      + +
    • +
    +
  10. +
+


+ +

Step 5: Setup RZ/V AI SDK

+

This step explains how to setup the RZ/V AI SDK environment.

+
+ Note + Make sure that you have installed Docker on your Linux PC. +
+
    +
  1. On your Linux PC, move to the working directory. + +
    cd ${WORK}/ai_sdk_setup
    + +
  2. +
  3. Build docker image.
    +
      +
    • For RZ/V2L + +
      docker build -t rzv2l_ai_sdk_image --build-arg SDK="/opt/poky/3.1.21" --build-arg PRODUCT="V2L" .
      + +
    • +
    • For RZ/V2H + +
      docker build -t rzv2h_ai_sdk_image --build-arg SDK="/opt/poky/3.1.26" --build-arg PRODUCT="V2H" .
      + +
    • +
    +
  4. +
  5. Create new directory to be mounted on Docker container. + +
    mkdir ${WORK}/ai_sdk_setup/data
    + +
  6. +
  7. Create docker container.
    Here, <rzv2l/rzv2h>_ai_sdk_container is a name of docker container, which can be changed by user. +
      +
    • For RZ/V2L + +
      docker run -it --name rzv2l_ai_sdk_container -v $(pwd)/data:/drp-ai_tvm/data rzv2l_ai_sdk_image
      + +
    • +
    • For RZ/V2H + +
      docker run -it --name rzv2h_ai_sdk_container -v $(pwd)/data:/drp-ai_tvm/data rzv2h_ai_sdk_image
      + +
    • +
    + The local $(pwd)/data is mounted to /drp-ai_tvm/data on the Docker container by the above command option.
    + For example, you can use this directory to copy files created on the Docker container to your local environment.

    + docker +

  8. +
  9. In docker container, run the following command to copy libtvm_runtime.so, which is the necessary file for the board, to host machine.
    + +
    cp /drp-ai_tvm/obj/build_runtime/${PRODUCT}/libtvm_runtime.so /drp-ai_tvm/data
    + +
  10. +
  11. To exit docker, run following commands.
    + +
    exit
    + +
  12. +
  13. To start the docker container again, run the following command.
    + +
    docker start -i <container_name, i.e., rzv2l_ai_sdk_container>
    + +
  14. +
+


+You have finished the RZ/V AI SDK environment setup.
+You are ready to build the AI applications! +

+ +

Step 6: Build RZ/V AI Application

+

This step explains how to build AI application. +
+To see the overview about AI Applications, please refer to About AI Applications (Link not available) page.
+ +
+ +
+
+

+
+ Note + Following procedures are for users who would like to build the application from the source code.
+ If you would like to run the application as quickly as possible, you can skip this step and proceed to the next step (Step 7: Deploy AI Application) since pre-build application binary is provided. +
+


+

Building instructions.

+

In AI Applications, there are two types of applications.

+ + + + + + + + + + + + + + + + + + + +
ApplicationGitHub RepositoryDetailsExample
<Application 1> +
+ +
+
+
+ These repositories provide the complete instruction in each application documentation. +
+
+
+ R01_object_detection +
+
<Application 2> +
+ +
+
+
+ This repository only contains AI Applications for RZ/V2L EVK.
+ It does not provide instructions for RZ/V AI SDK.
+ Please refer to the instruction provided in this page. +
+
+
+ 01_Head_count +
+
+ +



+ +

Step 7: Deploy AI Application

+

Please see each EVK Getting Started Step 7 for detailed instructions.
+ + + + +
+ + + + +
+

+

After Step 7, users should have completed followings. +

+

+


+ +

Step 8: Run AI Application

+ +

Please see each EVK Getting Started Step 8 for detailed instructions.
+ + + + +
+ + + + +
+

+

After Step 8, users should have completed followings. +

+

+
+ Note + To shutdown the board safely, please refer to followings.
+ +
+



+ +

+ This is the end of Getting Started. +

+

You have experienced the AI Application development procedures.
+Next step is to change the application to create your own AI Application.
+You can use the applications listed in AI Applications to expand your ideas! +

+ +

If you would like to customize Yocto Linux or develop your own board, please change and build the AI SDK Source Code based on your environment. +
+Please refer to How to Build AI SDK page shown below for more details.
+ + + + +
+ + + +

+ + + + + +
+ +
+ + + diff --git a/docs/_site/getting_started_v2h_internal.html b/docs/_site/getting_started_v2h_internal.html new file mode 100644 index 0000000..a8717aa --- /dev/null +++ b/docs/_site/getting_started_v2h_internal.html @@ -0,0 +1,914 @@ + + + + + + + + + + + + + +Renesas RZ/V AI | The best solution for starting your AI applications. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ + +

Renesas
RZ/V AI

+

2.10

+ + + +

The best solution for
starting your AI applications.

+

Provided by Renesas Electronics Corporation

+
+ + + + + +
+
+
+ board + +
+
+ ai_sdk + +
+
+
+ + + +

+

+ To keep you updated,
Watch our GitHub repository
+
+ Watch +

+ + +
+ + + +
+
+
+
+ +

This project is maintained by renesas-rz

+ +

Hosted on GitHub Pages — Theme by orderedlist

+
+
+
+ + + + + +
+
+
+RZ/V2H EVK Getting Started +
+
+
+
+ WARNING + + + This page is published for Renesas internal purpose only.
+ Do NOT distribute/share this page to external parties.
+ Since this page is still under the review process, the content may change in the official release.
+
+ Due to the necessary software unavailability (i.e., DRP-AI TVM, AI Applications),
+ you can only run following steps with this internal release. +
    +
  • + Step 2: Obtain necessary environment +
  • +
  • + Step 4: Extract RZ/V AI SDK package +
  • +
  • + Step 7: Deploy AI Application. +
      +
    • + 1. Setup RZ/V2H EVK +
    • +
    • + 3. Boot RZ/V2H EVK +
    • +
    +
  • +
  • + A4. Shutdown RZ/V2H EVK +
  • +
+
+
+
+


+

+ +
This page explains how to start-up the AI SDK on the RZ/V2H Evaluation Board Kit.
+ +
Supported version: RZ/V2H AI SDK v3.00
+ +
+ Terminology + +
+


+ +

Getting Started Flow

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

Introduction

+
+
+ +
+

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

+
+
+ board +
+
+
+
+ Following items are included in the RZ/V2H EVK. +
+
+ + + + + + + + + +
EquipmentDetails
RZ/V2H Evaluation BoardEvaluation board itself.
+
+
+
+
+
+
+


+

+ +
+
+
+

Step 7: Deploy AI Application

+ This section explains how to deploy the AI Application to the RZ/V2H EVK. +
+
+ +
+ 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.
+ docker +
+
+

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 4GB.
+ If you would like to expand the SD card image size, please build the RZ/V2H AI SDK Source Code according to Appendix 2 in How to Build RZ/V2H AI SDK (Link not available). +
+
    +
    +
  1. Install Necessary Software
  2. +
    + 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
    + +
    +
    +
  3. Write the Linux files to SD card
  4. +
    + 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. +

    + + + + + + + + + + + + +
    FileDescription
    core-image-weston-rzv2h-evk-ver1.wic.bmapSD card image
    core-image-weston-rzv2h-evk-ver1.wic.gz
    + Follow the instruction below to prepare the microSD card.
    +
    + Warning + Here, we use "/dev/sdb" as microSD card device name. +
    +
      +
    1. To use bmaptools, microSD card partitions must be unmounted.
      + Run the following command to check the automatically mounted microSD card partitions.
      + +
      df -h
      + +
    2. +
    3. + 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. +
      +
    4. +
    5. + 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. +
      +
    6. +
    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. +
    9. + Eject microSD card and insert it again to mount the partitions.

      +
    10. +
    11. + 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       3.8G  1.6G  2.0G  45% /media/user/root
        + +
        + Warning + Here, we use "/dev/sdb" as microSD card device name. +
        +
      • +
      +
    12. +
    13. 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.
      +
      +
      +
    14. +
    +
+
+

2. Deploy Application to the Board

+ This section explains how to copy the application binary created in 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. +
  3. + 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.
    +
    +
  4. +
  5. + Create the application directory on root filesystem. + +
    sudo mkdir /mnt/sd/home/root/tvm
    + +
    + Note + Directory name tvm can be determined by user.
    +
    +
  6. +
  7. + 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 
    + +
    +
  8. +
  9. + Run the following command to sync the data with memory. +
    + +
    sync 
    + +
  10. +
  11. + Run the following command to unmount the partition 2. +
    + +
    sudo umount /mnt/sd
    + +
  12. +
  13. + 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.
    +
    +
  14. +
+
+

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. +
  3. Change DSW1 and DSW2 setting as shown in the figure.

  4. +
  5. 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.
    +
    +

  6. +
  7. Connect the HDMI monitor to the Board.

  8. +
  9. Connect the power cable to the Board.

  10. +
  11. Turn the SW3 to ON.

  12. +
  13. Turn the SW2 to ON to power on the Board
  14. +
+
+
+ boot +
+
+
+
+
+
    +
  1. After the boot-up, following screen will be displayed on HDMI monitor.
  2. +
+
+
+ wayland +
+
+
+
+
    +
  1. Click the icon at the top-left corner to open the terminal.
  2. +
+
+
+ wayland +
+
+
+ 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

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

    + object_detection +
    +
    +
  2. +
+
+ 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.
+ + + + +
+
+
+


+ + + +
+ +
+ + + diff --git a/docs/_site/history.html b/docs/_site/history.html index 43cc9f2..9ca420b 100755 --- a/docs/_site/history.html +++ b/docs/_site/history.html @@ -30,10 +30,10 @@ +{"@context":"https://schema.org","@type":"WebPage","dateModified":"2024-01-26T14:34:19+09:00","description":"The best solution for starting your AI applications.","headline":"Renesas RZ/V AI","url":"https://renesas-rz.github.io/rzv_ai_sdk/2.10/history.html"} - + diff --git a/docs/_site/howto_build_aisdk.html b/docs/_site/howto_build_aisdk.html index 18d9336..a1f0859 100755 --- a/docs/_site/howto_build_aisdk.html +++ b/docs/_site/howto_build_aisdk.html @@ -33,7 +33,7 @@ {"@context":"https://schema.org","@type":"WebPage","dateModified":"2023-12-11T19:09:38+09:00","description":"The best solution for starting your AI applications.","headline":"Renesas RZ/V AI","url":"https://renesas-rz.github.io/rzv_ai_sdk/2.10/howto_build_aisdk.html"} - + diff --git a/docs/_site/howto_retrain.html b/docs/_site/howto_retrain.html index 2842c29..c3620b2 100644 --- a/docs/_site/howto_retrain.html +++ b/docs/_site/howto_retrain.html @@ -30,10 +30,10 @@ +{"@context":"https://schema.org","@type":"WebPage","dateModified":"2024-01-26T14:34:19+09:00","description":"The best solution for starting your AI applications.","headline":"Renesas RZ/V AI","url":"https://renesas-rz.github.io/rzv_ai_sdk/2.10/howto_retrain.html"} - + diff --git a/docs/_site/img/V2H_EVK_v1.jpg b/docs/_site/img/V2H_EVK_v1.jpg new file mode 100755 index 0000000..af298ab Binary files /dev/null and b/docs/_site/img/V2H_EVK_v1.jpg differ diff --git a/docs/_site/img/aisdk_sc_v2h.svg b/docs/_site/img/aisdk_sc_v2h.svg new file mode 100755 index 0000000..247fda1 --- /dev/null +++ b/docs/_site/img/aisdk_sc_v2h.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/_site/img/block_rzv.svg b/docs/_site/img/block_rzv.svg new file mode 100755 index 0000000..f077402 --- /dev/null +++ b/docs/_site/img/block_rzv.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/_site/img/board.svg b/docs/_site/img/board.svg new file mode 100755 index 0000000..6fe7475 --- /dev/null +++ b/docs/_site/img/board.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/_site/img/esd.svg b/docs/_site/img/esd.svg new file mode 100755 index 0000000..493ac3e --- /dev/null +++ b/docs/_site/img/esd.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/_site/img/getting_started_flow_base.svg b/docs/_site/img/getting_started_flow_base.svg new file mode 100755 index 0000000..22d751c --- /dev/null +++ b/docs/_site/img/getting_started_flow_base.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/_site/img/getting_started_flow_v2h.svg b/docs/_site/img/getting_started_flow_v2h.svg new file mode 100755 index 0000000..30e2cf9 --- /dev/null +++ b/docs/_site/img/getting_started_flow_v2h.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/_site/img/getting_started_flow_v2l.svg b/docs/_site/img/getting_started_flow_v2l.svg new file mode 100755 index 0000000..ca603ca --- /dev/null +++ b/docs/_site/img/getting_started_flow_v2l.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/_site/img/objectdetection_v2h.png b/docs/_site/img/objectdetection_v2h.png new file mode 100755 index 0000000..0bd9807 Binary files /dev/null and b/docs/_site/img/objectdetection_v2h.png differ diff --git a/docs/_site/img/rzv2h_evk_diagonal.jpg b/docs/_site/img/rzv2h_evk_diagonal.jpg new file mode 100755 index 0000000..9979c26 Binary files /dev/null and b/docs/_site/img/rzv2h_evk_diagonal.jpg differ diff --git a/docs/_site/img/v2h_evk_boot.png b/docs/_site/img/v2h_evk_boot.png new file mode 100755 index 0000000..28a1323 Binary files /dev/null and b/docs/_site/img/v2h_evk_boot.png differ diff --git a/docs/_site/img/v2h_evk_shutdown.png b/docs/_site/img/v2h_evk_shutdown.png new file mode 100755 index 0000000..a02d7ac Binary files /dev/null and b/docs/_site/img/v2h_evk_shutdown.png differ diff --git a/docs/_site/img/v2h_evk_wayland.png b/docs/_site/img/v2h_evk_wayland.png new file mode 100755 index 0000000..bc77433 Binary files /dev/null and b/docs/_site/img/v2h_evk_wayland.png differ diff --git a/docs/_site/img/v2h_mem.png b/docs/_site/img/v2h_mem.png new file mode 100755 index 0000000..926ddbe Binary files /dev/null and b/docs/_site/img/v2h_mem.png differ diff --git a/docs/_site/img/v2l_mem.png b/docs/_site/img/v2l_mem.png new file mode 100755 index 0000000..08b5958 Binary files /dev/null and b/docs/_site/img/v2l_mem.png differ diff --git a/docs/_site/index.html b/docs/_site/index.html index 25b5100..f3f8169 100755 --- a/docs/_site/index.html +++ b/docs/_site/index.html @@ -30,10 +30,10 @@ +{"@context":"https://schema.org","@type":"WebSite","dateModified":"2024-01-26T14:34:19+09:00","description":"The best solution for starting your AI applications.","headline":"Renesas RZ/V AI","name":"Renesas RZ/V AI","url":"https://renesas-rz.github.io/rzv_ai_sdk/2.10/"} - + diff --git a/docs/_site/sitemap.xml b/docs/_site/sitemap.xml old mode 100644 new mode 100755 index b56c658..784525a --- a/docs/_site/sitemap.xml +++ b/docs/_site/sitemap.xml @@ -2,7 +2,7 @@ https://renesas-rz.github.io/rzv_ai_sdk/latest/ai-sdk.html -2023-12-11T19:09:38+09:00 +2024-01-26T14:34:19+09:00 https://renesas-rz.github.io/rzv_ai_sdk/latest/appendix.html @@ -18,11 +18,11 @@ https://renesas-rz.github.io/rzv_ai_sdk/latest/getting_started.html -2023-12-11T19:09:38+09:00 +2024-01-26T14:34:19+09:00 https://renesas-rz.github.io/rzv_ai_sdk/latest/history.html -2023-12-11T19:09:38+09:00 +2024-01-26T14:34:19+09:00 https://renesas-rz.github.io/rzv_ai_sdk/latest/howto_build_aisdk.html @@ -30,11 +30,11 @@ https://renesas-rz.github.io/rzv_ai_sdk/latest/howto_retrain.html -2024-01-25T20:09:49+09:00 +2024-01-26T14:34:19+09:00 https://renesas-rz.github.io/rzv_ai_sdk/latest/ -2023-12-11T19:09:38+09:00 +2024-01-26T14:34:19+09:00 https://renesas-rz.github.io/rzv_ai_sdk/latest/version.html diff --git a/docs/_site/version.html b/docs/_site/version.html index f9a4de9..2d9abb6 100755 --- a/docs/_site/version.html +++ b/docs/_site/version.html @@ -33,7 +33,7 @@ {"@context":"https://schema.org","@type":"WebPage","dateModified":"2023-12-11T19:09:38+09:00","description":"The best solution for starting your AI applications.","headline":"Renesas RZ/V AI","url":"https://renesas-rz.github.io/rzv_ai_sdk/2.10/version.html"} - + diff --git a/docs/appendix_internal.md b/docs/appendix_internal.md new file mode 100755 index 0000000..f7e7cf7 --- /dev/null +++ b/docs/appendix_internal.md @@ -0,0 +1,883 @@ +--- +layout: default +--- + + + + +
+
+
+Getting Started Appendix +
+
+
+
+ WARNING + + + This page is published for Renesas internal purpose only.
+ Do NOT distribute/share this page to external parties.
+ Since this page is still under the review process, the content may change in the official release.
+
+ Due to the necessary software unavailability (i.e., DRP-AI TVM, AI Applications),
+ you can only run following steps with this internal release. +
    +
  • + Step 2: Obtain necessary environment +
  • +
  • + Step 4: Extract RZ/V AI SDK package +
  • +
  • + Step 7: Deploy AI Application. +
      +
    • + 1. Setup RZ/V2H EVK +
    • +
    • + 3. Boot RZ/V2H EVK +
    • +
    +
  • +
  • + A4. Shutdown RZ/V2H EVK +
  • +
+
+
+
+
+
+
This page explains the additional information of Getting Started.
+ +

A1. Setup for eMMC Bootloader

+This section explains how to setup the board for eMMC Bootloader. +
+
+ 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 and the bootloader written in eMMC on the board, skip this step and proceed to the next step (Step7:2. Deploy Application to the Board in Getting Started). +
+ +Follow the instruction below to setup the board. +
+ Note + Explanation in this step is for eMMC Bootloader, which requires Windows PC as serial communication console.
+
+ +
+After this procedure, you can copy the AI Application and boot the board.
+Refer to the Step 7: 2. Deploy Application to the Board in RZ/V2L EVK Getting Started (Link not available). +

+ +

A2. Format SD card

+ When writing the necessary files for the board, microSD card needs to have appropriate format.
+ Note that you need to run this procedure only once as long as you use the same microSD card. +

+ Follow the instruction below to format the microSD card partitions.
+
Preparation
+
+ Click the button + This section contains both eSD and eMMC Bootloader explanation.
+ Please click the button below to update the explanation according to your bootloader interface.
+
+ eSD Bootloader + eMMC Bootloader +
+
+ For eSD + eSD explanation will be shown in this style if you click "eSD Bootloader" button above. +
+
+ For eMMC + eMMC explanation will be shown in this style if you click "eMMC Bootloader" button above. +
+
+
+
Check the SD card connection
+
    +
  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. +{% highlight shell %} +lsblk +{% endhighlight %} + Following is the example output. +{% highlight shell %} +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 +{% endhighlight %} +

  2. +
  3. Insert the microSD card to your Linux PC and run the following command again. +{% highlight shell %} +lsblk +{% endhighlight %} +

  4. +
  5. Check the output and confirm the name appeared.
    + This would be your microSD card device name.
    +
      +
    • Following is the example output. +{% highlight shell %} +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 +{% endhighlight %} +
    • +
    • 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. +
      +
    • +
    +

  6. +
  7. Run the following command to check the automatically mounted microSD card partitions. +{% highlight shell %} +df +{% endhighlight %} +

  8. +
  9. Check the output and find the mount point, which is "/media/user/A8D3-393D" in the following example. +{% highlight shell %} +Filesystem 1K-blocks Used Available Use% Mounted on +udev 745652 0 745652 0% /dev +: +snip +: +/dev/sdb1 511720 4904 506816 1% /media/user/A8D3-393B +{% endhighlight %} +

  10. +
  11. Unmount the automatically mounted partitions. +{% highlight shell %} +sudo umount /media/user/A8D3-393B +{% endhighlight %} +
    • + If there are more than one partitions on microSD card, unmount all partitions. +
    +
  12. +
+
+
Create SD card partition
+
    +
  1. + Run fdisk command as shown below to change the partition table according to the following table. +
    +
    + For eSD + + + + + + + + + + + + + + + + + + + +
    Type/NumberSizeType of FilesystemContents
    Primary #1500MB (minimum 128MB)Ext4Linux kernel
    Device tree
    Primary #2All remainingExt4Root filesystem
    +
    + Note + "Type of Filesystem" of "Primary #1 Linux kernel and Device tree" Contents is Ext4.
    +
    +
    +
    + For eMMC + + + + + + + + + + + + + + + + + + + +
    Type/NumberSizeType of FilesystemContents
    Primary #1500MB (minimum 128MB)FAT32Linux kernel
    Device tree
    Primary #2All remainingExt4Root filesystem
    +
    + Note + "Type of Filesystem" of "Primary #1 Linux kernel and Device tree" Contents is FAT32.
    +
    +
    +
    +{% highlight shell %} +sudo fdisk /dev/sdb +{% endhighlight %} +
    + Warning + Use device name. Do NOT use partition name such as /dev/sdb1. +
    +
      +
    • Following log will be shown. +{% highlight shell %} +Welcome to fdisk (util-linux 2.34). +Changes will remain in memory only, until you decide to write them. +Be careful before using the write command. + +Command (m for help): +{% endhighlight %} +

    • +
    • Type "o" to console. The log continues. +{% highlight shell %} +Created a new DOS disklabel with disk identifier 0x6b6aac6e. + +Command (m for help): +{% endhighlight %} +

    • +
    • Type "n" to console. The log continues. +{% highlight shell %} +Partition type +p primary (0 primary, 0 extended, 4 free) +e extended (container for logical partitions) +Select (default p): +{% endhighlight %} +

    • +
    • Type "p" to console. The log continues. +{% highlight shell %} +Partition number (1-4, default 1): +{% endhighlight %} +

    • +
    • Press ENTER key. The log continues. +{% highlight shell %} +First sector (2048-62333951, default 2048): +{% endhighlight %} +

    • +
    • Press ENTER key. The log continues. +{% highlight shell %} +Last sector, +/-sectors or +/-size{K,M,G,T,P} (2048-62333951, +default 62333951): +{% endhighlight %} +

    • +
    • Type "+500M" to console. The log continues. +{% highlight shell %} +Created a new partition 1 of type 'Linux' and of size 500 MiB. +Partition #1 contains a vfat signature. + +Do you want to remove the signature? [Y]es/[N]o: +{% endhighlight %} +

    • +
    • Type "Y" to console. The log continues. +{% highlight shell %} +The signature will be removed by a write command. + +Command (m for help): +{% endhighlight %} +

    • +
    • Type "n" to console. The log continues. +{% highlight shell %} +Partition type +p primary (1 primary, 0 extended, 3 free) +e extended (container for logical partitions) +Select (default p): +{% endhighlight %} +

    • +
    • Type "p" to console. The log continues. +{% highlight shell %} +Partition number (2-4, default 2): +{% endhighlight %} +

    • +
    • Press ENTER key. The log continues. +{% highlight shell %} +First sector (1026048-62333951, default 1026048): +{% endhighlight %} +

    • +
    • Press ENTER key. The log continues. +{% highlight shell %} +Last sector, +/-sectors or +/-size{K,M,G,T,P} (1026048-62333951, +default 62333951): +{% endhighlight %} +

    • +
    • Press ENTER key. The log continues. +{% highlight shell %} +Created a new partition 2 of type 'Linux' and of size 29.2 GiB. + +Command (m for help): +{% endhighlight %} +

    • +
    • Type "p" to console. The log continues. +{% highlight shell %} +Disk /dev/sdb: 29.74 GiB, 31914983424 bytes, 62333952 sectors +Disk model: Transcend +Units: sectors of 1 \* 512 = 512 bytes +Sector size (logical/physical): 512 bytes / 512 bytes +I/O size (minimum/optimal): 512 bytes / 512 bytes + Disklabel type: dos +Disk identifier: 0x6b6aac6e + +Device Boot Start End Sectors Size Id Type +/dev/sdb1 2048 1026047 1024000 500M 83 Linux +/dev/sdb2 1026048 62333951 61307904 29.2G 83 Linux + +Filesystem/RAID signature on partition 1 will be wiped. + +Command (m for help): +{% endhighlight %} +
    • +
      + For eMMC + Additionally, run the following procedures to set the partition as FAT32. +
        +
      • Type "t" to console. The log continues. +{% highlight shell %} +Partition number (1,2, default 2): +{% endhighlight %} +

      • +
      • Type "1" to console. The log continues. +{% highlight shell %} +Hex code (type L to list all codes): +{% endhighlight %} +

      • +
      • Type "b" to console. The log continues. +{% highlight shell %} +Changed type of partition 'Linux' to 'W95 FAT32'. + +Command (m for help): +{% endhighlight %} +
      • +
      +
      +
      +
    • Type "w" to console. The fdisk interface will end. +{% highlight shell %} +The partition table has been altered. +Syncing disks. +{% endhighlight %} +
    • +
    +

  2. +
  3. Check the partition table with the command below. +{% highlight shell %} +partprobe +sudo fdisk -l /dev/sdb +{% endhighlight %} +
    • Output would be as follows. Note that there are two partitions. +
      + For eSD +{% highlight shell %} +Disk /dev/sdb: 29.74 GiB, 31914983424 bytes, 62333952 sectors +Disk model: Maker name etc. +Units: sectors of 1 * 512 = 512 bytes +Sector size (logical/physical): 512 bytes / 512 bytes +I/O size (minimum/optimal): 512 bytes / 512 bytes +Disklabel type: dos +Disk identifier: 0x6b6aac6e +Device Boot Start End Sectors Size Id Type +/dev/sdb1 2048 1026047 1024000 500M 83 Linux +/dev/sdb2 1026048 62333951 61307904 29.2G 83 Linux +{% endhighlight %} +
      +
      + For eMMC +{% highlight shell %} +Disk /dev/sdb: 29.74 GiB, 31914983424 bytes, 62333952 sectors +Disk model: Maker name etc. +Units: sectors of 1 * 512 = 512 bytes +Sector size (logical/physical): 512 bytes / 512 bytes +I/O size (minimum/optimal): 512 bytes / 512 bytes +Disklabel type: dos +Disk identifier: 0x6b6aac6e +Device Boot Start End Sectors Size Id Type +/dev/sdb1 2048 1026047 1024000 500M b W95 FAT32 +/dev/sdb2 1026048 62333951 61307904 29.2G 83 Linux +{% endhighlight %} +
      +
    +

  4. +
  5. Run the command below to format and mount the partitions 1. +
    + Note + If the partitions were automatically mounted after the procedure 6 of "Check the SD card connection", please unmount them again. +
    +
    + For eSD +{% highlight shell %} +sudo mkfs.ext4 -L boot /dev/sdb1 +{% endhighlight %} +
    • Following log will be shown. +{% highlight shell %} +mke2fs 1.45.5 (07-Jan-2020) +Creating filesystem with 128000 4k blocks and 128000 inodes +Filesystem UUID: 0d2b995c-dd96-4ff6-953c-66a4701fa034 +Superblock backups stored on blocks: + 32768, 98304 +Allocating group tables: done +Writing inode tables: done +Creating journal (4096 blocks): done +Writing superblocks and filesystem accounting information: done +{% endhighlight %} +
    +
    +
    + For eMMC +{% highlight shell %} +sudo mkfs.vfat -v -c -F 32 /dev/sdb1 +{% endhighlight %} +
    • Following log will be shown. +{% highlight shell %} +mkfs.fat 4.1 (2017-01-24) +/dev/sdb1 has 64 heads and 32 sectors per track, +hidden sectors 0x0800; +logical sector size is 512, +using 0xf8 media descriptor, with 1024000 sectors; +drive number 0x80; +filesystem has 2 32-bit FATs and 8 sectors per cluster. +FAT size is 1000 sectors, and provides 127746 clusters. +There are 32 reserved sectors. +Volume ID is a299e6a6, no volume label. +Searching for bad blocks 16848... 34256... 51152... 68304... 85072... 10209 +6... 119376... 136528... 153552... 170576... 187472... 204624... 221648... 238 +928... 256208... 273744... 290768... 308048... 325328... 342480... 359504... 3 +76656... 393680... 410576... 427216... 444624... 462032... 479184... 495952... +{% endhighlight %} +
    +
    +

  6. +
  7. Run the command below to format and mount the partitions 2. +{% highlight shell %} +sudo mkfs.ext4 -L rootfs /dev/sdb2 +{% endhighlight %} +
    • Following log will be shown. +{% highlight shell %} +mke2fs 1.45.5 (07-Jan-2020) +Creating filesystem with 7663488 4k blocks and 1916928 inodes +Filesystem UUID: 63dddb3f-e268-4554-af51-1c6e1928d76c +Superblock backups stored on blocks: +32768, 98304, 163840, 229376, 294912, 819200, 884736, 1605632, 2654208, +4096000 +Allocating group tables: done +Writing inode tables: done +Creating journal (32768 blocks): done +Writing superblocks and filesystem accounting information: done +{% endhighlight %} +
    +

  8. +
  9. Eject the microSD card and insert it again to remount the partitions. +
  10. +
+
+After this procedure, you can write the necessary data for the board into microSD card.
+Refer to the Write the Linux files to SD card in RZ/V2L EVK Getting Started (Link not available).
+ +

+ +

A3. Shutdown RZ/V2L EVK

+To power-off the RZ/V2L EVK, follow the procedures below. +

+ +
    +
  1. Run the shutdown command on board console. +
    +{% highlight shell %} +shutdown -h now +{% endhighlight %} +
  2. +
  3. On board console, check that shutdown procedure runs and ends with following log. +
    +{% highlight shell %} +[xxxxx.xxxxxx] reboot: Power down +{% endhighlight %} +
  4. +
  5. Press and hold the power button for 2 seconds. +

    + board
    +
  6. +
+
+

+

A4. Shutdown RZ/V2H EVK

+To power-off the RZ/V2H EVK, follow the procedures below. +

+
    +
  1. Run the shutdown command on board console. +
    +{% highlight shell %} +shutdown -h now +{% endhighlight %} +
  2. +
  3. On board console, check that shutdown procedure runs and ends with following log. +
    +{% highlight shell %} +[xxxxx.xxxxxx] reboot: Power down +{% endhighlight %} +
  4. +
  5. + Turn SW2 to OFF. +

    +
  6. +
  7. + Turn SW3 to OFF. +

    + board
    +
  8. +
+

+ + \ No newline at end of file diff --git a/docs/assets/css/style.scss b/docs/assets/css/style.scss index 2062304..ed2257c 100755 --- a/docs/assets/css/style.scss +++ b/docs/assets/css/style.scss @@ -57,11 +57,27 @@ h3 { font-style: italic; padding: 20px 10px; } -.download-button +.product-button +{ + //For default.html + // width:200px; + font-weight: bold; + color:#676767; + padding-left: 30px; + padding-right: 30px; + min-width: 187px; +} + +.download-button-yellow { font-weight: bold; + color:#676767; } +.download-button +{ + font-weight: bold; +} .square-button { font-weight: bold; @@ -70,7 +86,40 @@ h3 { background-color: #2a289d; border-color: #2a289d; } +.square-button-gray +{ + font-weight: bold; + font-size: medium; + border-radius: 0px; + background-color: #7c909b; + border-color: #7c909b; +} +.banner-title +{ + font-weight: bold; + font-size: 1.3em; + padding-right: 0.5em; +} +.banner-line-md +{ + display: block; + padding-left: 0.5em; + font-weight: normal; + font-size: 1.0em; +} +.banner-line +{ + display: block; + padding-left: 0.5em; + font-weight: normal; + font-size: 0.8em; +} +.table-small-text +{ + font-weight: normal; + font-size: 0.7em; +} .skip{ color: red; font-weight: bold; @@ -187,6 +236,9 @@ ul.index { list-style:none; margin: 0 0 0 0; } +.index-string { + color: #267CB9; +} p.downloads { padding:0; margin: 0 0 0 0; @@ -250,6 +302,7 @@ strong { display:block; color:#222; } + /*Use
for long line that requires break point on smartphone.*/ .br-sp { @@ -413,6 +466,12 @@ h3 { margin: 15px 0px; border-bottom: 2px solid #2a289d; } + +h4.u_line { + margin: 15px 5px; + padding: 5px 0px; + border-bottom: 1.5px solid #afafaf; +} .container{ max-width: 100%; } @@ -575,10 +634,38 @@ pre { overflow: auto; -webkit-overflow-scrolling: touch; } +.ham-display { + display: none; +} /********** Hamburger Menu **********/ @media print, screen and (max-width: 960px) { + .index-string { + color: white; + } + .ham-string { + color: white; + } + .ham-nodisplay { + display: none; + } + .ham-small { + font-size: 12px; + margin-bottom: 3px; + } + .ham-very-small { + font-size: 10px; + margin-bottom: 3px; + } + .ham-display { + display: block; + } + .product-button + { + width: auto; + min-width: none; + } .menu-btn { position: fixed; top: 5px; @@ -666,11 +753,13 @@ pre { } .menu-content details:has(ul) > summary > a{ border-bottom: none; - pointer-events: none; - } - .menu-content details:has(ul) > summary > a::before{ - content: none; + // Uncommented in order to allow users to click summary link. + // pointer-events: none; } + // Uncommented in order to jave arrow after summary link. + // .menu-content details:has(ul) > summary > a::before{ + // content: none; + // } .menu-content details > summary::before{ content: ""; width: 12px; @@ -922,4 +1011,131 @@ dl { display: flex; flex-wrap: wrap; margin: 0; -} \ No newline at end of file +} + +//Added by meistier for filtering function +/****************************************************/ + @media (max-width: 991px) { + #application-filter { + position: fixed; + top: 56px; + right: 0; + width: 50%; + max-height: 80vh; + overflow-y: auto; + display: none; + } + #filter-title { + background-color: #706f6f; + color: white; + padding: 10px; + position: sticky; + top: 0; + z-index: 1; + width: 100%; + } + #application-filter-body { + color: white; + padding-top: 0; + padding: 10px; + padding-bottom: 10px; + background-color: #706f6f; + margin-top: -15px; + } + #application-filter-visible-button { + display: none; + position: fixed; + top: 60px; + right: 0px; + z-index: 2; + color: #000077; + display: block; + + } + #application-filter-erase-button { + position: relative; + display: none; + color:darkgrey; + padding: 0; + margin: 0px 0px 0px -30px; + box-shadow: none; + } + #application-filter-hide-button { + position: relative; + top: -80px; + right: -50%; + display: none; + color: #2a289d; + } + #category-filter-titlecolor { + color: white; + border-bottom-color: white; + } + #filter-titlecolor { + color: white; + margin-bottom: 0; + } + } + + @media (min-width: 992px) { + #application-filter { + position: fixed; + top: 56px; + right: 0; + width: 200px; + max-height: 80vh; + overflow-y: auto; + } + #filter-title { + background-color: #fff; + padding: 10px; + position: sticky; + top: 0; + z-index: 1; + width: 100%; + } + #application-filter-body { + padding-top: 0; + padding: 10px; + padding-bottom: 10px; + margin-top: -10%; + } + #application-filter-visible-button { + display: none; + position: fixed; + top: 60px; + right: 0px; + z-index: 2; + color: #000077; + display: block; + } + #application-filter-erase-button { + position: relative; + display: none; + color:darkgrey; + padding-left: 0; + margin-left: -20%; + margin-top: -30px; + margin-bottom: -10px; + box-shadow: none; + } + #application-filter-erase-button :hover{ + color:dodgerblue; + } + #application-filter-hide-button { + position: relative; + display: none; + } + } + +#application-filter-button-container { + position: fixed; + top: 145px; + right: 30px; + z-index: 2; +} + +.checkbox-group:hover{ + color:dodgerblue; +} + diff --git a/docs/getting_started_internal.md b/docs/getting_started_internal.md new file mode 100755 index 0000000..086e97a --- /dev/null +++ b/docs/getting_started_internal.md @@ -0,0 +1,964 @@ +--- +layout: default +--- + + +
+
+
+Getting Started +
+
+
+
+ WARNING + + + This page is published for Renesas internal purpose only.
+ Do NOT distribute/share this page to external parties.
+ Since this page is still under the review process, the content may change in the official release.
+
+ Due to the necessary software unavailability (i.e., DRP-AI TVM, AI Applications),
+ you can only run following steps with this internal release. +
    +
  • + Step 2: Obtain necessary environment +
  • +
  • + Step 4: Extract RZ/V AI SDK package +
  • +
  • + Step 7: Deploy AI Application. +
      +
    • + 1. Setup RZ/V2H EVK +
    • +
    • + 3. Boot RZ/V2H EVK +
    • +
    +
  • +
  • + A4. Shutdown RZ/V2H EVK +
  • +
+
+
+
+
+
+
This page explains how to start-up the AI SDK.
+AI SDK is build for specific board.
+Its version varies depending on the supported board. + + + + + + + + + + + + + +
Supported BoardSupported AI SDK
RZ/V2L Evaluation Board KitRZ/V2L AI SDK v2.10
RZ/V2H Evaluation Board KitRZ/V2H AI SDK v3.00
+Learn more about the RZ/V series. + + +
+ Note + Hereafter, we use following terminology.
+
    +
  • RZ/V AI SDK: Refers both RZ/V2L AI SDK and RZ/V2H AI SDK.
  • +
  • EVK: Refers "Evaluation Board Kit".
  • +
+
+
+ +
+ Tutorial video + Tutorial video is available here.
+ Latest tutorial video is based on RZ/V2L AI SDK version 2.10.
+
+ +

Introduction

+
+
+
+

Getting Started Flow

+ Getting Started explains the instruction to run AI Applications.
+ Common instructions are explained in this document.
+ Board dependent instructions are explained in each EVK Getting Started page.
+ flow +
+
+
+
+

Software

+ Renesas provides following software. +

+ + + + + + + + + + + + + + + + + + + + + +
SoftwareProvided onDetails
AI ApplicationsGitHub + This software is a set of following files that runs on the evaluation board kit.
+
    +
  • + Application Source code (C++) +
  • +
  • + Pre-build application binary +
  • +
  • + Other necessary files to run the application +
  • +
  • + Documentation (README.md) +
  • +
+ "Getting Started" page (this page) explains how to run the AI Applications. +
RZ/V AI SDKRenesas Website + This software is a development environment for AI Applications.
+ Provided as a zip file.
+ "Getting Started" page (this page) explains how to use RZ/V AI SDK to run the AI Applications. +
RZ/V AI SDK
Source Code
Renesas Website + This software is the source code of RZ/V AI SDK.
+ Provided as a zip file.
+ It includes Yocto Linux recipe.
+ Details and instructions are explained in the following pages.
+ + + + +
+ + + + +
+
+
+
+ +

Step 1: Obtain an evaluation board

+
+
+
+ To start using RZ/V AI SDK, we need to get the board.
+ Renesas provides ideal board kit for evaluation.
+
+ Click the button below to get the board.
+ + + + +
+
+ To see the details of the board, please see EVK Getting Started.
+ + + + +
+ + + + +
+
+
+ +
+
+
+ The RZ/V2L Evaluation Board Kit (EVK) is the ideal board kit for RZ/V2L evaluation. +

+ Since MIPI camera module is included, you can start evaluating RZ/V2L immediately by building an environment. +

+ Get RZ/V2L EVK +
+
+ board +
+
+
+
+ Following items are included in the RZ/V2L Evaluation Board Kit. +

+ + + + + + + + + + + + + + + + + +
EquipmentDetails
RZ/V2L Evaluation BoardEvaluation board itself.
MIPI Camera ModuleGoogle Coral Camera.
+
Note that the CMOS sensor (OV5645) in the camera is no longer available, and should not be used for mass production.
Any software support provided is for evaluation purposes only.
MicroUSB to Serial CableFor serial communication between PC and the board.
+
+
+
+
+
+ +

Step 2: Obtain necessary environment

+

1. Necessary Equipments

+ Please prepare the following equipments for your EVK.
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ForEquipmentDetails
+ RZ/V2L + + RZ/V2L EVK + + Evaluation Board Kit for RZ/V2L.
Includes followings. +
    +
  • + MIPI Camera Module(Google Coral Camera) +
    +
    + Note that the CMOS sensor (OV5645) in the camera is no longer available, and should not be used for mass production.
    + Any software support provided is for evaluation purposes only. +
    +
  • +
  • MicroUSB to Serial Cable for serial communication.
  • +
+
+ AC Adapter + + USB Power Delivery adapter for the board power supply. +
+ MicroHDMI Cable + + Used to connect the HDMI Monitor and the board.
+ RZ/V2L EVK has microHDMI port. +
+ USB Camera + + Optional. AI Applications support USB camera input.
+ Supported resolution: 640x480
+ Supported format: 'YUYV' (YUYV 4:2:2) +
+ Windows PC + + Optional. Used as the serial communication console for eMMC Bootloader.
+ Operating Environment : Windows 10 +
+ RZ/V2H + + RZ/V2H EVK + + Evaluation Board Kit for RZ/V2H. +
+ AC Adapter + + USB Power Delivery adapter for the board power supply.
+ 100W is required. +
+ HDMI Cable + + Used to connect the HDMI Monitor and the board.
+ RZ/V2H EVK has HDMI port. +
+ USB Camera + + Since RZ/V2H EVK does not include camera module, this will be the standard camera input source.
+ Supported resolution: 640x480
+ Supported format: 'YUYV' (YUYV 4:2:2)
+
+ To use MIPI camera, please refer to e-CAM22_CURZH provided by e-con Systems.
+ e-CAM22_CURZH camera supports FHD(1920x1080) resolution. +
+
+ Common + + USB Cable Type-C + + Connect AC adapter and the board. +
+ HDMI Monitor + + Used to display the graphics of the board. +
+ microSD card + + Must have over 4GB capacity of blank space.
+ Operating Environment: Transcend UHS-I microSD 300S 16GB +
+ Linux PC + + Used for Setup microSD card and RZ/V AI SDK Setup.
+ Operating Environment: Ubuntu 20.04 +
+ SD card reader + + Used for setting up microSD card. +
+ USB Hub + + Used to connect USB Keyboard and USB Mouse to the board. +
+ USB Keyboard + + Used to type strings on the terminal of board. +
+ USB Mouse + + Used to operate the mouse on the screen of board. +
+
+ Note + USB camera has different supported resolution and format.
+ To check the specification of your USB camera, use v4l2-ctl command. +
+ + In addition to the RZ/V2L Evaluation Board Kit, please prepare the following equipments.
+
+ Note + Serial to MicroUSB Cable and MIPI Camera Module (Google Coral camera) is included in RZ/V2L Evaluation Board Kit. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
EquipmentDetails
HDMI MonitorUsed to display the graphics.
Micro HDMI CableUsed to connect the HDMI Monitor and the board.
AC adapterPower supply to the board.
USB Cable Type-CConnect AC adapter and the board.
microSD cardMust have over 4GB capacity of blank space.
Operating Environment: Transcend UHS-I microSD 300S 16GB
Linux PCUsed for Setup microSD card and RZ/V2L AI SDK Setup.
+ Operating Environment: Ubuntu 20.04
SD card readerUsed for setting up microSD card.
Windows PCOptional. Used as the serial communication console for eMMC Bootloader.
+ Operating Environment : Windows 10
USB HubUsed to connect USB Keyboard and USB Mouse.
USB KeyboardUsed to type strings on the terminal of board.
USB MouseUsed to operate the mouse on the screen of board.
+
+
+

2. Necessary Software

+

Please install following software on Linux PC.

+ +
+ +

Step 3: Obtain RZ/V AI SDK

+RZ/V AI SDK provides following packages for each supported board. + + + + + + + + + + + + + + + + +
NamePackageDetails
RZ/V AI SDKRTK0EF0*SJ.zipPackage used for AI development.
RZ/V AI SDK
Source Code
RTK0EF0*SJ_linux-src.zipPackage used for Linux development.
+ Please refer to following pages for more details on this package.
+ + + + +
+ + + + +
+For this Getting Started, please download "RZ/V AI SDK" for your preferred device from the link below.
+ + + + +

+Once downloaded, please check the Release Note included in the package. +

+ +

Step 4: Extract RZ/V AI SDK package

+This step explains how to extract the RZ/V AI SDK zip file. +
    +
  1. On your Linux PC, make the working directory. +{% highlight shell %} +mkdir -p ai_sdk_work +{% endhighlight %} +
  2. +
  3. Register the working directory path to an environment variable. +{% highlight shell%} +export WORK=/ai_sdk_work +{% endhighlight %} +
  4. +
  5. Move to the working directory. +{% highlight shell%} +cd ${WORK} +{% endhighlight %} +
  6. +
  7. Extract RZ/V AI SDK zip file under the working directory. +{% highlight shell%} +unzip /RTK0EF0*.zip -d ${WORK} +{% endhighlight %} +
  8. +
  9. Check the working directory to confirm the package contents. +{% highlight shell%} +ls ${WORK}/ +{% endhighlight %} +
      +
    • If the above command prints followings, the package is extracted correctly. +{% highlight shell%} +ai_sdk_setup board_setup documents references r11an0*.pdf +{% endhighlight %} +
    • +
    +
  10. +
+
+ +

Step 5: Setup RZ/V AI SDK

+This step explains how to setup the RZ/V AI SDK environment. +
+ Note + Make sure that you have installed Docker on your Linux PC. +
+
    +
  1. On your Linux PC, move to the working directory. +{% highlight shell%} +cd ${WORK}/ai_sdk_setup +{% endhighlight %} +
  2. +
  3. Build docker image.
    +
      +
    • For RZ/V2L +{% highlight shell%} +docker build -t rzv2l_ai_sdk_image --build-arg SDK="/opt/poky/3.1.21" --build-arg PRODUCT="V2L" . +{% endhighlight %} +
    • +
    • For RZ/V2H +{% highlight shell%} +docker build -t rzv2h_ai_sdk_image --build-arg SDK="/opt/poky/3.1.26" --build-arg PRODUCT="V2H" . +{% endhighlight %} +
    • +
    +
  4. +
  5. Create new directory to be mounted on Docker container. +{% highlight shell%} +mkdir ${WORK}/ai_sdk_setup/data +{% endhighlight %} +
  6. +
  7. Create docker container.
    Here, _ai_sdk_container is a name of docker container, which can be changed by user. +
      +
    • For RZ/V2L +{% highlight shell%} +docker run -it --name rzv2l_ai_sdk_container -v $(pwd)/data:/drp-ai_tvm/data rzv2l_ai_sdk_image +{% endhighlight %} +
    • +
    • For RZ/V2H +{% highlight shell%} +docker run -it --name rzv2h_ai_sdk_container -v $(pwd)/data:/drp-ai_tvm/data rzv2h_ai_sdk_image +{% endhighlight %} +
    • +
    + The local $(pwd)/data is mounted to /drp-ai_tvm/data on the Docker container by the above command option.
    + For example, you can use this directory to copy files created on the Docker container to your local environment.

    + docker +

  8. +
  9. In docker container, run the following command to copy libtvm_runtime.so, which is the necessary file for the board, to host machine.
    +{% highlight shell%} +cp /drp-ai_tvm/obj/build_runtime/${PRODUCT}/libtvm_runtime.so /drp-ai_tvm/data +{% endhighlight %} +
  10. +
  11. To exit docker, run following commands.
    +{% highlight shell%} +exit +{% endhighlight %} +
  12. +
  13. To start the docker container again, run the following command.
    +{% highlight shell%} +docker start -i +{% endhighlight %} +
  14. +
+
+You have finished the RZ/V AI SDK environment setup.
+You are ready to build the AI applications! +

+ +

Step 6: Build RZ/V AI Application

+This step explains how to build AI application. +
+To see the overview about AI Applications, please refer to About AI Applications (Link not available) page.
+ +
+ +
+
+
+
+ Note + Following procedures are for users who would like to build the application from the source code.
+ If you would like to run the application as quickly as possible, you can skip this step and proceed to the next step (Step 7: Deploy AI Application) since pre-build application binary is provided. +
+
+

Building instructions.

+In AI Applications, there are two types of applications. + + + + + + + + + + + + + + + + + + + +
ApplicationGitHub RepositoryDetailsExample
+
+ +
+
+
+ These repositories provide the complete instruction in each application documentation. +
+
+
+ R01_object_detection +
+
+
+ +
+
+
+ This repository only contains AI Applications for RZ/V2L EVK.
+ It does not provide instructions for RZ/V AI SDK.
+ Please refer to the instruction provided in this page. +
+
+
+ 01_Head_count +
+
+ +

+ +

Step 7: Deploy AI Application

+Please see each EVK Getting Started Step 7 for detailed instructions.
+ + + + +
+ + + + +
+
+

After Step 7, users should have completed followings. +

+

+
+ +

Step 8: Run AI Application

+ +Please see each EVK Getting Started Step 8 for detailed instructions.
+ + + + +
+ + + + +
+
+

After Step 8, users should have completed followings. +

+

+
+ Note + To shutdown the board safely, please refer to followings.
+ +
+

+ +

+ This is the end of Getting Started. +

+You have experienced the AI Application development procedures.
+Next step is to change the application to create your own AI Application.
+You can use the applications listed in AI Applications to expand your ideas! +

+ +If you would like to customize Yocto Linux or develop your own board, please change and build the AI SDK Source Code based on your environment. +
+Please refer to How to Build AI SDK page shown below for more details.
+ + + + +
+ + + + + + + \ No newline at end of file diff --git a/docs/getting_started_v2h_internal.md b/docs/getting_started_v2h_internal.md new file mode 100755 index 0000000..d38ce2b --- /dev/null +++ b/docs/getting_started_v2h_internal.md @@ -0,0 +1,521 @@ +--- +layout: default +--- + + +
+
+
+RZ/V2H EVK Getting Started +
+
+
+
+ WARNING + + + This page is published for Renesas internal purpose only.
+ Do NOT distribute/share this page to external parties.
+ Since this page is still under the review process, the content may change in the official release.
+
+ Due to the necessary software unavailability (i.e., DRP-AI TVM, AI Applications),
+ you can only run following steps with this internal release. +
    +
  • + Step 2: Obtain necessary environment +
  • +
  • + Step 4: Extract RZ/V AI SDK package +
  • +
  • + Step 7: Deploy AI Application. +
      +
    • + 1. Setup RZ/V2H EVK +
    • +
    • + 3. Boot RZ/V2H EVK +
    • +
    +
  • +
  • + A4. Shutdown RZ/V2H EVK +
  • +
+
+
+
+
+
+ +
This page explains how to start-up the AI SDK on the RZ/V2H Evaluation Board Kit.
+ +
Supported version: RZ/V2H AI SDK v3.00
+ +
+ Terminology + +
+
+ +

Getting Started Flow

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

Introduction

+
+
+ +
+

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

+
+
+ board +
+
+
+
+ Following items are included in the RZ/V2H EVK. +
+
+ + + + + + + + + +
EquipmentDetails
RZ/V2H Evaluation BoardEvaluation board itself.
+
+
+
+
+
+
+
+
+ +
+
+
+

Step 7: Deploy AI Application

+ This section explains how to deploy the AI Application to the RZ/V2H EVK. +
+
+ +
+ 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.
+ docker +
+
+

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 4GB.
+ If you would like to expand the SD card image size, please build the RZ/V2H AI SDK Source Code according to Appendix 2 in How to Build RZ/V2H AI SDK (Link not available). +
+
    +
    +
  1. Install Necessary Software
  2. +
    + 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).
    +{% highlight shell %} +sudo apt install bmap-tools +{% endhighlight %} +
    +
    +
  3. Write the Linux files to SD card
  4. +
    + Run the below command to decompress ${WORK}/board_setup/eSD.zip.
    +{% highlight shell %} +cd ${WORK}/board_setup +unzip eSD.zip +{% endhighlight %} + Following files are necessary.
    + They are in the ${WORK}/board_setup/eSD directory. +

    + + + + + + + + + + + + +
    FileDescription
    core-image-weston-rzv2h-evk-ver1.wic.bmapSD card image
    core-image-weston-rzv2h-evk-ver1.wic.gz
    + Follow the instruction below to prepare the microSD card.
    +
    + Warning + Here, we use "/dev/sdb" as microSD card device name. +
    +
      +
    1. To use bmaptools, microSD card partitions must be unmounted.
      + Run the following command to check the automatically mounted microSD card partitions.
      +{% highlight shell %} +df -h +{% endhighlight %} +
    2. +
    3. + Check the output and find the mount point, which is "/media/user/9016-4EF8" in the following example. +{% highlight shell%} +Filesystem Size Used Avail Use% Mounted on +: +snip +: +/dev/sdb1 15G 32K 15G 1% /media/user/9016-4EF8 +{% endhighlight %} +
      + Warning + Here, we use "/dev/sdb" as microSD card device name. +
      +
    4. +
    5. + Unmount the automatically mounted partitions. +{% highlight shell%} +sudo umount /media/user/9016-4EF8 +{% endhighlight %} +
      + Note + If there are more than one partitions on microSD card, unmount all partitions. +
      +
    6. +
    7. Run the following command to write SD card image.
      +{% highlight shell %} +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 +{% endhighlight %} +
      + Warning + Change /dev/sdb to your microSD card device name.
      +
      +
    8. +
    9. + Eject microSD card and insert it again to mount the partitions.

      +
    10. +
    11. + Run the following command to check two partitions are created on microSD card.
      +{% highlight shell %} +df -h +{% endhighlight %} +
        +
      • + If the command shows following log, two partitions are created on microSD card successfully.
        +{% highlight shell %} +Filesystem Size Used Avail Use% Mounted on +: +snip +: +/dev/sdb1 17M 3.0M 14M 18% /media/user/bootloaderf +/dev/sdb2 3.8G 1.6G 2.0G 45% /media/user/root +{% endhighlight %} +
        + Warning + Here, we use "/dev/sdb" as microSD card device name. +
        +
      • +
      +
    12. +
    13. Run the following commands to setup the partition 2, which is the root filesystem of the board.
      +{% highlight shell %} +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 +{% endhighlight %} +
      + 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. +
      +{% highlight shell %} +sudo eject /dev/sdb +{% endhighlight %} +
      + Warning + Change /dev/sdb to your microSD card device name.
      +
      +
      +
    14. +
    +
+
+

2. Deploy Application to the Board

+ This section explains how to copy the application binary created in 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. +
  3. + Run the following command to mount the partition 2, which contains the root filesystem.
    +{% highlight shell %} +sudo mount /dev/sdb2 /mnt/sd +{% endhighlight %} +
    + Warning + Change /dev/sdb to your microSD card device name.
    +
    +
  4. +
  5. + Create the application directory on root filesystem. +{% highlight shell %} +sudo mkdir /mnt/sd/home/root/tvm +{% endhighlight %} +
    + Note + Directory name tvm can be determined by user.
    +
    +
  6. +
  7. + 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. +

    +{% highlight shell %} +sudo cp $WORK/ai_sdk_setup/data// /mnt/sd/home/root/tvm +{% endhighlight %} +
    +
  8. +
  9. + Run the following command to sync the data with memory. +
    +{% highlight shell %} +sync +{% endhighlight %} +
  10. +
  11. + Run the following command to unmount the partition 2. +
    +{% highlight shell %} +sudo umount /mnt/sd +{% endhighlight %} +
  12. +
  13. + Eject the microSD card by running the following command and remove the microSD card from Linux PC.
    +{% highlight shell %} +sudo eject /dev/sdb +{% endhighlight %} +
    + Warning + Change /dev/sdb to your microSD card device name.
    +
    +
  14. +
+
+

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. +
  3. Change DSW1 and DSW2 setting as shown in the figure.

  4. +
  5. 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.
    +
    +

  6. +
  7. Connect the HDMI monitor to the Board.

  8. +
  9. Connect the power cable to the Board.

  10. +
  11. Turn the SW3 to ON.

  12. +
  13. Turn the SW2 to ON to power on the Board
  14. +
+
+
+ boot +
+
+
+
+
+
    +
  1. After the boot-up, following screen will be displayed on HDMI monitor.
  2. +
+
+
+ wayland +
+
+
+
+
    +
  1. Click the icon at the top-left corner to open the terminal.
  2. +
+
+
+ wayland +
+
+
+ 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

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

    + object_detection +
    +
    +
  2. +
+
+ 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.
+ + + + +
+
+
+
+ \ No newline at end of file diff --git a/docs/img/V2H_EVK_v1.jpg b/docs/img/V2H_EVK_v1.jpg new file mode 100755 index 0000000..af298ab Binary files /dev/null and b/docs/img/V2H_EVK_v1.jpg differ diff --git a/docs/img/aisdk_sc_v2h.svg b/docs/img/aisdk_sc_v2h.svg new file mode 100755 index 0000000..247fda1 --- /dev/null +++ b/docs/img/aisdk_sc_v2h.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/img/block_rzv.svg b/docs/img/block_rzv.svg new file mode 100755 index 0000000..f077402 --- /dev/null +++ b/docs/img/block_rzv.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/img/board.svg b/docs/img/board.svg new file mode 100755 index 0000000..6fe7475 --- /dev/null +++ b/docs/img/board.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/img/esd.svg b/docs/img/esd.svg new file mode 100755 index 0000000..493ac3e --- /dev/null +++ b/docs/img/esd.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/img/getting_started_flow_base.svg b/docs/img/getting_started_flow_base.svg new file mode 100755 index 0000000..22d751c --- /dev/null +++ b/docs/img/getting_started_flow_base.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/img/getting_started_flow_v2h.svg b/docs/img/getting_started_flow_v2h.svg new file mode 100755 index 0000000..30e2cf9 --- /dev/null +++ b/docs/img/getting_started_flow_v2h.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/img/getting_started_flow_v2l.svg b/docs/img/getting_started_flow_v2l.svg new file mode 100755 index 0000000..ca603ca --- /dev/null +++ b/docs/img/getting_started_flow_v2l.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/img/objectdetection_v2h.png b/docs/img/objectdetection_v2h.png new file mode 100755 index 0000000..0bd9807 Binary files /dev/null and b/docs/img/objectdetection_v2h.png differ diff --git a/docs/img/rzv2h_evk_diagonal.jpg b/docs/img/rzv2h_evk_diagonal.jpg new file mode 100755 index 0000000..9979c26 Binary files /dev/null and b/docs/img/rzv2h_evk_diagonal.jpg differ diff --git a/docs/img/v2h_evk_boot.png b/docs/img/v2h_evk_boot.png new file mode 100755 index 0000000..28a1323 Binary files /dev/null and b/docs/img/v2h_evk_boot.png differ diff --git a/docs/img/v2h_evk_shutdown.png b/docs/img/v2h_evk_shutdown.png new file mode 100755 index 0000000..a02d7ac Binary files /dev/null and b/docs/img/v2h_evk_shutdown.png differ diff --git a/docs/img/v2h_evk_wayland.png b/docs/img/v2h_evk_wayland.png new file mode 100755 index 0000000..bc77433 Binary files /dev/null and b/docs/img/v2h_evk_wayland.png differ diff --git a/docs/img/v2h_mem.png b/docs/img/v2h_mem.png new file mode 100755 index 0000000..926ddbe Binary files /dev/null and b/docs/img/v2h_mem.png differ diff --git a/docs/img/v2l_mem.png b/docs/img/v2l_mem.png new file mode 100755 index 0000000..08b5958 Binary files /dev/null and b/docs/img/v2l_mem.png differ