Download Print this page

StarFive VisionFive 2 Quick Start Manual

Ai kit
Hide thumbs Also See for VisionFive 2:

Advertisement

Quick Links

VisionFive 2 AI Kit Quick Start Guide
Version: 1.0
Date: 2024/11/07
Doc ID: VisionFive 2-QSGCH-002

Advertisement

loading
Need help?

Need help?

Do you have a question about the VisionFive 2 and is the answer not in the manual?

Questions and answers

Summary of Contents for StarFive VisionFive 2

  • Page 1 VisionFive 2 AI Kit Quick Start Guide Version: 1.0 Date: 2024/11/07 Doc ID: VisionFive 2-QSGCH-002...
  • Page 2: Legal Statements

    StarFive does not assume any liability rising out of the application or use of any product or circuit, and specifically disclaims any and all liability, including without limitation indirect, incidental, special, exemplary, or consequential damages.
  • Page 3: Table Of Contents

    List of Tables.......................................4 List of Figures..................................... 5 Legal Statements....................................2 Preface........................................6 1. Introduction..................................7 2. Preparation..................................8 2.1. Hardware Preparation.................................8 2.2. Software Preparation................................8 3. Compilation..................................11 4. Demo....................................13 5. Appendix....................................16 © 2018-2024 StarFive Technology www.starfivetech.com All rights reserved...
  • Page 4: List Of Tables

    Contents List of Tables Table 0-1 Version History................................... 6 www.starfivetech.com © 2018-2024 StarFive Technology All rights reserved...
  • Page 5: List Of Figures

    Contents List of Figures Figure 2-1 VisionFive 2 AI Kit................................8 Figure 3-1 Missing head file................................11 Figure 3-2 Error....................................11 Figure 3-3 Hailo-8 Module Information............................12 Figure 4-1 Enable Hailo Monitor..............................13 Figure 4-2 Specify environment variables............................13 Figure 4-3 Monitor Data.................................. 13 Figure 4-4 Change Startup Scripts..............................
  • Page 6: Preface

    Preface About this guide and technical support information. About this document This document mainly provides the users with basic information and compilation methods about StarFive VisionFive 2 AI Kit, including hardware and software preparation, compilation, demo cases. Version History Table 0-1 Version History...
  • Page 7: Introduction

    1. Introduction VisionFive 2 AI Kit is jointly launched by StarFive and Hailo. It aims to provide the most cost-effective high-performance RISC-V AI solutions for applications in edge computing, industrial intelligence, security, robotics, gateway routing, smart home and other fields.
  • Page 8: Preparation

    • A mouse Connection Type The Hailo-8L AI acceleration module is connected through the M.2 M-Key of VisionFive 2, as shown in the following figure: Tip: StarFive recommends you to use a heart sink or a fan for heat dissipation.
  • Page 9 Debian into SD card. Tip: StarFive recommendS you to perform following operations under user account to avoid permission exceptions caused by root account. 2. Update kernel and head files: a. Run the following command to download and extract the hailort-deb-1.tar.gz file: $ tar -xzvf hailort-deb-1.tar.gz...
  • Page 10 $ git checkout ac19e12b86170e1b0967e7d8aa607a0100cb0077 $ cp path_to_hailo_patches/0001-Added-HailoRT-adaptation-to-VisionFive2.patch ./ $ git apply 0001-Added-HailoRT-adaptation-to-VisionFive2.patch • Run the following command to obtain the HailoRT-drivers source code and apply it: $ git clone https://github.com/hailo-ai/hailort-drivers.git hailort-driver $ git checkout eb2a8649752abd424c6d2e5109e9ec92d6d2d5f6 www.starfivetech.com © 2018-2024 StarFive Technology All rights reserved...
  • Page 11: Compilation

    2. Firmware download and automatic loading settings. a. Run the following command to enter the top-level path of the pcie-driver source code: hailort-driver $./download_firmware.sh $ sudo mkdir -p /lib/firmware/hailo/ $ sudo mv hailo8_fw.<VERSION>.bin /lib/firmware/hailo/hailo8_fw.bin © 2018-2024 StarFive Technology www.starfivetech.com All rights reserved...
  • Page 12: Figure 3-3 Hailo-8 Module Information

    You can view the connected Hailo-8 module information: Figure 3-3 Hailo-8 Module Information Tappas Run the following command to enter the top-level directory of Tappas source code: tappas/ $ ./install.sh --skip-hailort --target-platform vf2 $ source /home/user/.hailo/tappas/tappas_env www.starfivetech.com © 2018-2024 StarFive Technology All rights reserved...
  • Page 13: Demo

    4. Demo System Setting After booting up, StarFive recommends to turn off CPU auto frequency regulation and run the following command under root: $ su - echo performance > /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor Enable HailoRT Monitor (optional) 1. Run the following command to enable Hailo monitor, which can monitor the utilization rate of NPU devices, models...
  • Page 14: Figure 4-4 Change Startup Scripts

    | 4 - Demo Note: The demo under Tappas uses GStreamer videosink with xvimagesink and ximagesink, while VisionFive 2's Debian uses Wayland protocol, these demos need to modify their startup scripts by changing the ximagesink in video_stink_ element to waylandink:...
  • Page 15: Figure 4-7 Error

    2. Download the required resources: $ ./get_sources.sh 3. Run the following command to demo target recognition: ◦ $ ./build/tests/TestExecutable -i /dev/video4 -m models/yolov8s_nms.json -a yolov8_nms ◦ $ ./build/tests/TestExecutable -i /dev/video4 -m models/yolov8s_pose.json -a yolov8_pose © 2018-2024 StarFive Technology www.starfivetech.com All rights reserved...
  • Page 16: Appendix

    5. Appendix Click to buy USB Camera. www.starfivetech.com © 2018-2024 StarFive Technology All rights reserved...