1. Manuals
  2. Brands
  3. StarFive Manuals
  4. Single board computers
  5. VisionFive 2
  6. Quick start manual

StarFive VisionFive 2 Quick Start Manual

Hide thumbs Also See for VisionFive 2:
Table of Contents

Advertisement

Quick Links

Download this manual
VisionFive 2 Single Board
Computer Quick Start Guide
Version: 1.2
Date: 2023/02/28
Doc ID: VisionFive2-QSGEN-001

Advertisement

Table of Contents
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

Subscribe to Our Youtube Channel

Related Manuals for StarFive VisionFive 2

Summary of Contents for StarFive VisionFive 2

  • Page 1 VisionFive 2 Single Board Computer Quick Start Guide Version: 1.2 Date: 2023/02/28 Doc ID: VisionFive2-QSGEN-001...
  • Page 2 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 About this guide and technical support information. About this document This document mainly provides the users with the necessary information about the StarFive VisionFive 2 development board, including features, specifications, board appearance, and pinout, as well as the guidelines to get started with the Debian operating system.
  • Page 4 Notes and notices The following notes and notices might appear in this guide: • Tip: Suggests how to apply the information in a topic or step. • Note: Explains a special case or expands on an important point. • Important: Points out critical information concerning a topic or step.

  • Page 5: Table Of Contents

    2.1. Board Appearance........................13 2.2. Pinout Diagram........................15 3. Getting Started........................17 3.1. Required Hardware......................17 3.2. Connecting a Fan to VisionFive 2..................19 3.3. Flashing OS to a Micro-SD Card................... 19 3.3.1. Flashing with Linux or Windows................19 3.4. Logging into Debian......................20 3.4.1.

  • Page 6: List Of Tables

    Contents List of Tables Table 0-1 Revision History........................iii Table 2-1 Board Appearance Description................... 14 Table 4-1 GitHub Repository Addresses....................40 Table 4-2 Boot Mode Settings......................41 www.starfivetech.com © 2018-2023 StarFive Technology All rights reserved...

  • Page 7: List Of Figures

    Figure 3-15 Example Output....................... 28 Figure 3-16 Example Output....................... 29 Figure 3-17 Example Output....................... 29 Figure 4-1 Connecting to the Debug Pins of VisionFive 2 40-pin GPIO Header........36 Figure 4-2 Boot Mode Setting (UART)....................36 Figure 4-3 Example Output......................... 37 Figure 4-5 Example Output.........................

  • Page 8: Features And Specifications

    • IMG BXE-4-32 MC1 with work frequency up to 600 MHz Memory VisionFive 2 provides the system memory of 2 GB, 4 GB, or 8 GB LPDDR4 SDRAM up to 2,800 Mbps. Storage • Onboard TF card slot: The VisionFive 2 can boot from the TF card.

  • Page 9: Interfaces

    ◦ 5 V (on 2 pins) ◦ Ground (on 8 pins) ◦ GPIO ◦ CAN bus ◦ DMIC ◦ I2C ◦ I2S ◦ PWM ◦ SPI ◦ UART ◦ and so on © 2018-2023 StarFive Technology www.starfivetech.com All rights reserved...

  • Page 10: Software

    Memory: 2 GB/4 GB/8 GB LPDDR4 SDRAM, up to 2,800 Mbps Storage: Onboard TF card slot The VisionFive 2 can boot from a TF card. Flash The firmware to store U-Boot and bootloader. Multimedia: Video Output • 1 × 2-lane MIPI DSI display port, support­...
  • Page 11 • 3.3 V (on 2 pins) • 5 V (on 2 pins) • Ground (on 8 pins) • GPIO • CAN bus • DMIC • I2C • I2S • PWM • SPI © 2018-2023 StarFive Technology www.starfivetech.com All rights reserved...
  • Page 12 • 1-bit QSPI Nor Flash • SDIO3.0 • eMMC • UART Button: Reset button To reset VisionFive 2, press and hold the Reset button for more than 3 seconds to ensure the reset is successful. Dimensions: 100 × 74 mm Compliance:...

  • Page 13: Hardware Overview

    2. Hardware Overview This chapter provides the hardware overview of VisionFive 2. 2.1. Board Appearance Figure 2-1 Board Appearance (Top View) Figure 2-2 Board Appearance (Bottom View) © 2018-2023 StarFive Technology www.starfivetech.com All rights reserved...
  • Page 14 | 2 - Hardware Overview CAUTION: During the use of VisionFive 2, avoid contact with hard objects that may cause damage. Table 2-1 Board Appearance Description Description Description StarFive JH7110 with RISC-V quad- 2 × Ethernet Ports (RJ45) core CPU, supporting RV64GC ISA PoE Header HDMI 2.0 Port...

  • Page 15: Pinout Diagram

    GPIO54 GPIO47 GPIO51 3.3V Power GPIO52 (SPI MOSI) GPIO50 GPIO53 (SPI MISO) GPIO49 (SPI CE0) GPIO48 (SPI SCLK) GPIO56 GPIO40 GPIO45 GPIO37 GPIO46 (PWM0) GPIO39 GPIO59 (PWM1) GPIO36 GPIO63 GPIO61 GPIO60 GPIO44 © 2018-2023 StarFive Technology www.starfivetech.com All rights reserved...
  • Page 16 • All GPIOs can be configured to support different functions including but not limited to SDIO, Audio, SPI, I2C, UART, and PWM. For the instructions, refer to the VisionFive 2 40-Pin GPIO Header User Guide. www.starfivetech.com © 2018-2023 StarFive Technology All rights reserved...

  • Page 17: Getting Started

    • Power adapter • USB Type-C cable Note: During the use of VisionFive 2, avoid contact with hard objects that may cause damage. Thus, StarFive recommends that you use spacers for the following NPTHs (Non Plating Through Hole): Figure 3-1 NPTHs on VisionFive 2...

  • Page 18: Figure 3-2 Single Head Hexagonal Copper Columns

    Figure 3-2 Single Head Hexagonal Copper Columns • Double way hexagon copper studs (Size: M2.5*4) Figure 3-3 Double Way Hexagon Copper Studs Note: The recommended SSD mounting screw for VisionFive 2 is M2 × 3 mm (Head Diameter: 5.0 mm). Figure 3-4 SSD Mounting Location www.starfivetech.com ©...

  • Page 19: Connecting A Fan To Visionfive 2

    Now we need to burn Debian (which is a Linux distribution) to a micro-SD card so that it can run on the VisionFive 2. This chapter provides example steps to flash Debian to a Micro-SD card with Linux or Windows.

  • Page 20: Logging Into Debian

    Perform the following steps to log into Debian: 1. Connect a display to VisionFive 2 via HDMI. 2. Insert the TF card with the Debian image into VisionFive 2 and power it on. 3. Enter the credentials as follows: • Username: root •...

  • Page 21: Using Xfce Desktop Over Hdmi

    Manual. 3.4.1. Using Xfce Desktop over HDMI After installing Debian, you can log in to Debian OS on VisionFive 2 using Xfce Desktop over HDMI. Steps: 1. After the HDMI of the display screen is connected, insert the micro-SD card with the Fedora image into the VisionFive and power on.

  • Page 22: Using Ssh Over Ethernet

    You will see the following interface: Figure 3-7 Debian Interface 3.4.2. Using SSH over Ethernet After installing Debian, you can log in to Debian OS on VisionFive 2 through an SSH connection over the local network. 1. Enable SSH root login as described in Enable SSH Root Login (on page 32).

  • Page 23: Figure 3-8 Example Output

    | 3 - Getting Started Tip: You can easily find the IP address of the VisionFive 2 by referring to its host name, starfive 3. Download and install Putty by visiting this link. Tip: Putty is an SSH and telnet client through which you can connect to the Carrier Board.

  • Page 24: Using A Usb To Serial Converter

    2. Go to DHCP configuration and find the IP address of the VisionFive 2. Tip: You can easily find the IP address of the VisionFive 2 by referring to its host name, starfive. 3. Open a terminal window and type the following: ssh root@192.168.1.xxx...

  • Page 25: Figure 3-10 Connecting Jumper Wire

    1. Insert the micro-SD card with the Debian image burnt into VisionFive 2. 2. Connect one end of the USB Type-C cable to the USB Type-C port on the VisionFive 2, and connect the other end of the cable to the power adapter.

  • Page 26: Figure 3-11 Example

    8. Open Putty to connect the PC to the Carrier Board. a. Select Serial under the Connection Type. b. Configure the settings as follows: • Serial line: COM4 (choose your COM port) • Speed: 115200 www.starfivetech.com © 2018-2023 StarFive Technology All rights reserved...

  • Page 27: Figure 3-12 Example Configuration

    1. Insert the micro-SD card with the Debian image burnt into VisionFive 2. 2. Connect one end of the USB Type-C cable to the USB Type-C port on the VisionFive 2, and connect the other end of the cable to the power adapter.

  • Page 28: Figure 3-14 Connecting Jumper Wires

    | 3 - Getting Started 3. Connect the jumper wires between the USB-to-Serial converter and the 40-Pin GPIO header of the VisionFive 2 as follows. Figure 3-14 Connecting Jumper Wires 5V Power 3.3V Power 5V Power GPIO58 (I2C SDA) GPIO57 (I2C SCL)

  • Page 29: Figure 3-16 Example Output

    11. Type username and password in the prompt as follows: • Username: root • Password: starfive Result: Now you have connected with the VisionFive 2 via serial communication using MacOS/Linux! Figure 3-17 Example Output © 2018-2023 StarFive Technology www.starfivetech.com All rights reserved...

  • Page 30: Appendix

    This disk is currently in use - repartitioning is probably a bad idea. It's recommended to umount all file systems, and swapoff all swap partitions on this disk. Command (m for help): d Partition number (1-4, default 4): 4 www.starfivetech.com © 2018-2023 StarFive Technology All rights reserved...
  • Page 31 The following output indicates the modification is successful: root@starfive:~# df -h Filesystem Size Used Avail Use% Mounted on udev 3.7G 3.7G 0% /dev tmpfs 793M 3.1M 790M 1% /run /dev/mmcblk1p4 1.9G 7% / tmpfs 3.9G 3.9G 0% /dev/shm © 2018-2023 StarFive Technology www.starfivetech.com All rights reserved...

  • Page 32: Enable Ssh Root Login

    Result: $ ssh root@192.168.1.172 root@192.168.1.172's password: Linux starfive 5.15.0-starfive #1 SMP Fri Feb 24 03:26:44 EST 2023 riscv64 The programs included with the Debian GNU/Linux system are free software; the exact distribution terms for each program are described in the individual files in /usr/share/doc/*/copyright.

  • Page 33: Updating Spl And U-Boot

    1. Prepare the TFTP server. The following is an example command for Ubuntu distribution. sudo apt install tftpd-hpa 2. Power on VisionFive 2 and wait until it enters the U-Boot command line interface. 3. Configure the environment variables by executing: setenv ipaddr 192.168.120.222;setenv serverip 192.168.120.99...
  • Page 34 Example Command and Output: # flashcp -v u-boot-spl.bin.normal.out /dev/mtd0 Erasing blocks: 32/32 (100%) Writing data: 124k/124k (100%) Verifying data: 124k/124k (100%) # flashcp -v visionfive2_fw_payload.img /dev/mtd1 Erasing blocks: 682/682 (100%) Writing data: 2727k/2727k (100%) www.starfivetech.com © 2018-2023 StarFive Technology All rights reserved...

  • Page 35: Updating Spl And U-Boot Of Sd Card And Emmc

    Tip: <X>: The application value is for SD card and for eMMC. Example command and output: root@starfive:~# dd if=u-boot-spl.bin.normal.out of=/dev/mmcblk1p1 conv=fsync 255+1 records in 255+1 records out 130688 bytes (131 kB, 128 KiB) copied, 0.033136 s, 3.9 MB/s root@starfive:~# dd if=visionfive2_fw_payload.img of=/dev/mmcblk1p2...

  • Page 36: Figure 4-1 Connecting To The Debug Pins Of Visionfive 2 40-Pin Gpio Header

    1. Connect the jumper wires between the USB-to-Serial converter and the Debug pins of VisionFive 2 40-pin GPIO header. The following figure is an example: Figure 4-1 Connecting to the Debug Pins of VisionFive 2 40-pin GPIO Header 5V Power 3.3V Power...

  • Page 37: Figure 4-3 Example Output

    115200 4. Power up, you will see an output like this: CCCCCCCCCCCCCCCCCCCCC 5. Transfer the recovery binary (jh7110-recovery-20221205.bin) by XMODEM. The recovery binary is located at: https://github.com/starfive-tech/Tools/tree/master/recovery. Figure 4-3 Example Output © 2018-2023 StarFive Technology www.starfivetech.com All rights reserved...

  • Page 38: Figure 4-5 Example Output

    | 4 - Appendix and press Enter on your keyboard to update SPL binary <u-boot- 6. Type spl.bin.normal.out>. Figure 4-5 Example Output www.starfivetech.com © 2018-2023 StarFive Technology All rights reserved...

  • Page 39: Figure 4-7 Example Output

    | 4 - Appendix and press Enter on your keyboard to update U-Boot binary 7. Type <visionfive2_fw_payload.img>. Figure 4-7 Example Output © 2018-2023 StarFive Technology www.starfivetech.com All rights reserved...

  • Page 40: Github Repository

    4.5. GitHub Repository The following table describes the GitHub Repository addresses: Note: Make sure you have switched to the corresponding branch. Table 4-1 GitHub Repository Addresses Type Repository Branch Linux Linux JH7110_VisionFive2_devel www.starfivetech.com © 2018-2023 StarFive Technology All rights reserved...

  • Page 41: Boot Mode Settings

    OpenSBI master Debian Debian 4.6. Boot Mode Settings VisionFive 2 provides pins to determine the boot mode before it is powered up. The following are the available boot modes and details. Table 4-2 Boot Mode Settings Boot Mode RGPIO_0 RGPIO_1 1-bit QSPI Nor Flash SDIO3.0...

  • Page 42: Figure 4-9 Boot Mode Settings

    | 4 - Appendix Figure 4-9 Boot Mode Settings www.starfivetech.com © 2018-2023 StarFive Technology All rights reserved...

Table of Contents