Table of Contents

Advertisement

VisionFive 2 Single Board Computer
Quick Start Guide
Version: 1.61
Date: 2023/04/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

Summary of Contents for Starfire VisionFive 2

  • Page 1 VisionFive 2 Single Board Computer Quick Start Guide Version: 1.61 Date: 2023/04/28 Doc ID: VisionFive2-QSGEN-001...
  • Page 2 Legal Statements Important legal notice before reading our documentation. PROPRIETARY NOTICE Copyright © Shanghai StarFive Technology Co., Ltd., 2023. All rights reserved. Information in this document is provided "as is," with all faults. Contents may be periodically updated or revised due to the product development.
  • 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 Table 0-1 Revision History (continued) Version Released Revision • Removed a redundant step in Logging into Debian (on page 18) • Added Step 1 in Using SSH over Ethernet (on page 19). • Added a new method in Updating SPL and U-Boot of Flash (on page 29).
  • Page 5: Table Of Contents

    2.1. Board Appearance................................12 2.2. Pinout Diagram................................. 14 3. Getting Started.................................. 15 3.1. Required Hardware................................15 3.2. Connecting a Fan to VisionFive 2............................. 16 3.3. Flashing OS to a Micro-SD Card............................17 3.3.1. Flashing with Linux or Windows..........................17 3.4. Logging into Debian................................18 3.4.1.
  • Page 6: List Of Tables

    Contents List of Tables Table 0-1 Revision History.................................iii Table 2-1 Board Appearance Description............................13 Table 4-1 GitHub Repository Addresses............................35 Table 4-2 Boot Mode Settings................................. 36 www.starfivetech.com © 2018-2023 StarFive Technology All rights reserved...
  • Page 7: List Of Figures

    Figure 3-15 Example Output................................25 Figure 3-16 Example Output................................26 Figure 3-17 Example Output................................26 Figure 4-1 Connecting to the Debug Pins of VisionFive 2 40-pin GPIO Header ................31 Figure 4-2 Boot Mode Setting (UART)............................. 32 Figure 4-3 Example Output................................32 Figure 4-5 Example Output................................33 Figure 4-7 Example Output................................34...
  • 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: 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. © 2018-2023 StarFive Technology www.starfivetech.com All rights reserved...
  • Page 10 | 1 - Features and Specifications Type Item Description Multimedia: Video Output • 1 × 2-lane MIPI DSI display port, supporting up to 1080p@30fps • 1 × 4-lane MIPI DSI display port, supporting up to 2K@30fps in both single display and dual display modes.
  • Page 11 • 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: RoHS, FCC, CE...
  • Page 12: 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) www.starfivetech.com © 2018-2023 StarFive Technology All rights reserved...
  • Page 13 | 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-core CPU, 2 × Ethernet Ports (RJ45) supporting RV64GC ISA PoE Header HDMI 2.0 Port...
  • Page 14: Pinout Diagram

    GPIO pins. • 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 ©...
  • Page 15: Getting Started

    • USB Type-C cable Warning: 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 For spacers, StarFive strongly recommends that you use the copper columns or studs with the following specifications: •...
  • Page 16: Connecting A Fan To Visionfive 2

    • 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 3.2. Connecting a Fan to VisionFive 2 You can connect a 2-pin 5 V fan to VisionFive 2 for further cooling as follows: www.starfivetech.com...
  • Page 17: Flashing Os To A Micro-Sd Card

    3.3. Flashing OS to a Micro-SD Card 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 18: Logging Into Debian

    StarFive recommends that you use SD card or eMMC mode since the versions of SPL and U-Boot in the QSPI flash may be outdated and require update. 3. Insert the TF card with the Debian image into VisionFive 2 and power it on. 4. Enter the credentials as follows: ◦...
  • Page 19: Using Desktop Over Hdmi

    1. Insert the micro-SD card with the Debian image into the VisionFive 2 and power on. 2. Connect one end of an Ethernet cable to the RJ45 connector on the VisionFive 2 and the other end of the cable to a router.
  • Page 20 | 3 - Getting Started 3. After a successful Ethernet connection, your router will assign an IP address to the VisionFive 2 and it will be connected to the Internet. 4. Continue the steps according to your OS: ◦ For Windows (on page 20) ◦...
  • Page 21: Figure 3-8 Example Output

    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 hostname, starfive. 3. (Optional) Decide the user account. If you need to use the...
  • Page 22: Using A Usb To Serial Converter

    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 23: Figure 3-11 Example

    | 3 - Getting Started 4. Connect the USB-to-Serial converter to the PC. 5. Open Device Manager by typing Device Manager in the windows search box. 6. Click the drop-down arrow from Ports (COM & LPT) and find the name of the connected serial port (e.g.: COM4). Figure 3-11 Example 7.
  • Page 24: 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 25: Figure 3-14 Connecting Jumper Wires

    | 3 - Getting Started Figure 3-14 Connecting Jumper Wires 5V Power 3.3V Power 5V Power GPIO58 (I2C SDA) GPIO57 (I2C SCL) GPIO5 (UART TX) GPIO55 GPIO6 (UART RX) GPIO38 GPIO42 GPIO43 GPIO54 GPIO47 GPIO51 3.3V Power GPIO52 (SPI MOSI) GPIO50 GPIO53 (SPI MISO) GPIO49 (SPI CE0)
  • Page 26: Figure 3-16 Example Output

    The following example use to login. user root user ◦ Username: user ◦ Password: starfive Result: Now you have connected with the VisionFive 2 via serial communication using MacOS/Linux! Figure 3-17 Example Output www.starfivetech.com © 2018-2023 StarFive Technology All rights reserved...
  • Page 27: Appendix

    4. Appendix 4.1. Using SSH over Ethernet as Root Account After the new system is installed, the rejected connection denial appears when you try to log on to the Debian Linux server as a root user. Here is the example information: $ ssh root@192.168.120.41 ssh: connect to host 192.168.120.41 port 22: Connection refused To enable SSH root login, perform the following steps:...
  • Page 28 | 4 - Appendix root@starfive:~# fdisk /dev/mmcblk<X> Tip: <X>: The application value is for SD card and for eMMC. Example Output: root@starfive:~# fdisk /dev/mmcblk1 Welcome to fdisk (util-linux 2.38.1). Changes will remain in memory only, until you decide to write them. Be careful before using the write command.
  • Page 29: Updating Spl And U-Boot

    VisionFive Single Board Computer Quick Start Guide. 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 4. Check the connectivity by pinging the host PC from VisionFive 2.
  • Page 30: Updating Spl And U-Boot Of Sd Card And Emmc

    | 4 - Appendix Note: This method only supports versions equal to or later than VF2_v2.5.0. 1. Install the mtd-utils package by executing the following command: apt install mtd-utils 2. Transfer the latest u-boot-spl.bin.normal.out and visionfive2_fw_payload.img files to Debian system through SCP. 3.
  • Page 31: Recovering The Bootloader

    In these situations, it's better to recover the bootloader. 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:...
  • Page 32: Figure 4-2 Boot Mode Setting (Uart)

    | 4 - Appendix Figure 4-2 Boot Mode Setting (UART) 3. Configure the serial port baud rate settings to bps. 115200 4. Power up, you will see an output like this: CCCCCCCCCCCCCCCCCCCCC 5. Transfer the latest recovery binary (jh7110-recovery-<Version>.bin) by XMODEM. The recovery binary is located at: https://github.com/starfive-tech/Tools/tree/master/recovery.
  • Page 33: Figure 4-5 Example Output

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

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

    | 4 - Appendix 8. Power off and switch jumpers back to Flash mode (RGPIO_1,RGPIO_0: 0,0). 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...
  • Page 36: Boot Mode Settings

    | 4 - Appendix 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 37: Figure 4-9 Boot Mode Settings

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

Table of Contents

Save PDF