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).
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.
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...
• 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 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 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...
• 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: •...
• 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...
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.
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: ◦...
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) ◦...
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...
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.
| 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.
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.
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.
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.
| 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.
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:...
| 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.
| 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...
| 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...
Need help?
Do you have a question about the VisionFive 2 and is the answer not in the manual?
Questions and answers