¶ PROPRIETARY NOTICE
Copyright © Shanghai StarFive Technology Co., Ltd., 2018-2022. 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. Shanghai StarFive Technology Co., Ltd. (hereinafter “StarFive”) reserves the right to make changes without further notice to any products herein.
StarFive expressly disclaims all warranties, representations, and conditions of any kind, whether express or implied, including, but not limited to, the implied warranties or conditions of merchantability, fitness for a particular purpose and non-infringement.
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.
All material appearing in this document is protected by copyright and is the property of StarFive. You may use this document or any part of the document for internal or educational purposes only, provided you do not modify, edit or take out of context the information in this document in any manner. Information contained in this document may be used, at your sole risk, for any purposes. StarFive authorizes you to copy this document, provided that you retain all copyright and other proprietary notices contained in the original materials on any copies of the materials and that you comply strictly with these terms. This copyright permission does not constitute an endorsement of the products or services.
¶ About This Manual
¶ Introduction
This document mainly provides the users with the necessary information about StarFive VisionFive development board, including features, specifications, board appearance and pinout, as well as the guidelines to get started with Fedora operation system.
¶ Revision History
| Version | Released | Revision |
|---|---|---|
| V1.0 | 2021-12-08 | The first official release. |
| V1.1 | 2022-03-01 | - Added new steps to use Ethernet to prepare software under Windows and Mac/Linux environment in the Software Setup section. - Updated the Fedora image file name as Fedora-riscv64-jh7100-developer-xfce-Rawhide-20211226-214100.n.0-sda.raw.zst. - Added steps to recover bootloader for Mac/Linux. - Updated the description in Software Setup. |
¶ Features and Specifications
VisionFive is the first generation of affordable RISC-V computers designed to run Linux. It is fully open-source with open-source software, open hardware design and RISC-V open architecture.
It is powered by RISC-V SiFive U74 Dual-Core 64-bit RV64GC ISA SoC with 8GB LPDDR4 RAM and has rich I/O peripherals such as USB 3.0 ports, 40-pin GPIO header, Gigabit Ethernet Connector, Micro-SD card slot and much more.
VisionFive also has rich AI features with Neural Network Engine and NVDLA Engine. It has onboard audio and video processing capabilities and has MIPI-CSI and MIPI-DSI connectors for video hardware. It has wireless capabilities with Wi-Fi and Bluetooth (BLE) and has a wide software compatibility including support for Fedora.
¶ Features
-
Truly open-source hardware, software and RISC-V open architecture
-
Powerful and rich AI features with Neural Network Engine and NVDLA Engine
-
Abundant I/O peripherals
-
Wireless connectivity with Wi-Fi and BLE
-
Onboard video and audio processing
-
Wide software compatibility including support for Fedora
¶ Specifications
Table ‑ Specifications
| Specification | Details |
| Processor | - RISC-V SiFive U74 Dual-Core 64-bit RV64GC ISA SoC with 2MB L2 cache @ 1.0GHz - Vision DSP Tensilica-VP6 for computing vision @ 600MHz - NVDLA Engine (configuration 2048 MACs @ 800MHz) - Neural Network Engine (1024MACs @ 500MHz) |
| Memory | 8GB LPDDR4 |
| Wireless Connectivity | - 2.4 GHz Wi-Fi (IEEE 802.11b/g/n) - Bluetooth 4.2 (BLE) |
| Video | - 2 x MIPI-CSI (up to 4K@30fps), 1 x MIPI-DSI (up to 4K@30fps) - 1 x HDMI 2.0 (up to 1080p@60fps display) - Video Decoder (H264/H265) up to 4K@60fps; Support Dual stream decoding for 2K@30fps each - Dual channels of ISP, each channel support up to 4K@30FPS - Support MIPI-CSI TX for video output after ISP and AI processing - JPEG encoder/decoder |
| Dedicated Audio Processing DSP and Sub-system | - Ultra-low power Voice Activity Detector for audio bit-stream as a Voice Trigger - On-chip Audio DAC - Support DMIC and AMIC, up to 4 channels |
| Peripherals | - 4 x USB 3.0 ports - 40 Pin GPIO Header (28 x GPIO, I2C, I2S, SPI, UART) - Gigabit Ethernet Connector - 3.5 mm Audio jack (4-pole stereo audio output) - Micro-SD card slot for system boot and data storage - Support TRNG and OTP - Support DMAC, QSPI and other peripheral - Reset button and Power Button |
| Power Supply | - Minimum: 5 V / 1.5 A - Recommended: 5 V / 3 A |
| Power Connector | - USB Type-C port or 40-pin GPIO header |
| Dimensions | - 100 mm x 72 mm |
¶ Hardware Overview
¶ Board Appearance
Figure - Top View of VisionFive
Figure ‑ Bottom View of VisionFive
Table ‑ Interface Description
|
No. | Description | No. | Description |
| 1 | RISC-V SiFive U74 Dual-Core 64-bit RV64GC ISA SoC | 9 | HDMI 2.0 Connector |
| 2 | 4GB LPDDR4 RAM | 10 | 2 x MIPI-CSI Connector |
| 3 | 2.4 GHz Wi-Fi and Bluetooth 4.2 (BLE) | 11 | Gigabit Ethernet (RJ45 Connector) |
| 4 | 40 Pin GPIO Header | 12 | 2 x USB 3.0 Host Type-A |
| 5 | MIPI-DSI Connector | 13 | 2 x USB 3.0 Host Type-A |
| 6 | PMIC | 14 | 3.5 mm Audio Jack (4-pole stereo audio output) |
| 7 | USB Type-C Connector | 15 | Micro-SD SDXC Card Slot |
| 8 | LCD to HDMI IC | 16 | Fan Header for a 2-pin 5 V Fan |
Notes:
The recommended current for this board is 3 A. The reason is as the following:
The onboard components need about 1 A, the 4 USB ports can draw a total of 1 A combined, one USB port alone can also draw 1 A and the remaining current is for expansion header and others.
¶ Pinout Diagram
The following is the pinout diagram:
Figure ‑ Pinout Diagram
Notes:
Each GPIO pin can safely draw a maximum current of 39 mA, whereas the maximum current draw when all GPIOs are combined should be less than 100 mA. Please take this into account or otherwise you will end up destroying the 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 StarFive_40-Pin_GPIO_Header_User_Guide.
¶ Getting Started
¶ Required Hardware
You need to prepare the following hardware before getting started with VisionFive：
-
VisionFive
-
16GB (or more) micro-SD card
-
micro-SD card reader
-
Computer (PC/Mac/Linux)
-
USB to serial converter (3.3 V I/O)
-
Ethernet cable
-
Power adapter (5 V / 3 A)
-
USB Type-C Cable
¶ Connecting a Fan
You can connect a 2-pin 5 V fan to the board as follows:
Figure - Connecting a Fan
¶ Flashing Fedora OS to a Micro-SD Card
Now we need to burn Fedora (which is a Linux distribution) to a micro-SD card, so that it can run on the VisionFive. Follow the steps below according to your operating system.
Start by downloading the Fedora image from here.
¶ For Windows
Steps:
-
Insert a micro-SD card to the computer through a micro-SD card reader, or by a built-in card reader on a laptop.
-
Download Zstandard-CLI software by visiting the links below:
-
Click here to visit the GitHub repo.
-
Extract the
.zipfile. -
Copy the latest file (e.g.:
Fedora-riscv64-jh7100-developer-xfce-Rawhide-20211226-214100.n.0-sda.raw.zst) and paste it into the zstd directory that you just extracted. -
Open Windows Powershell and navigate to the zstd directory.
Example:cd D:\Downloads\zstd -
Type the following command to unzip the Fedora image:
./zstd.exe -d Fedora-riscv64-jh7100-developer-xfce-Rawhide-20211226-214100.n.0-sda.raw.zst -o Fedora-riscv64-jh7100-developer-xfce-Rawhide-20211226-214100.n.0-sda.rawResult:
Now your image file is named asFedora-riscv64-jh7100-developer-xfce-Rawhide-20211226-214100.n.0-sda.raw. -
Visit this link to download BalenaEtcher. We will use BalenaEtcher software to flash the Fedora image to a micro-SD card.
-
Install BalenaEtcher and open it.
Figure - Install BalenaEtcher -
Click on Flash from file and select the location of the image that we just unzipped:
Fedora-riscv64-jh7100-developer-xfce-Rawhide-20211226-214100.n.0-sda.raw -
Click Select target and select the connected micro-SD card.
-
Click Flash!
¶ For Mac/Linux
Steps:
-
Insert a micro-SD card to the computer through a micro-SD card reader, or by a built-in card reader on a laptop.
-
Open a terminal window on Mac/Linux.
-
Type the following to update the packages list.
sudo apt-get updateInformation:
If you are a Mac user, typebrew update. -
Type the following to install zstd package which we will use to unzip our Fedora image file:
sudo apt-get install zstdInformation:
If you are a Mac user, typebrew install zstd. -
Navigate to the location of the downloaded Fedora image directory before.
Example Command:cd Downloads/ -
Run the following command to unzip the Fedora image.
zstd -d Fedora-riscv64-jh7100-developer-xfce-Rawhide-20211226-214100.n.0-sda.raw.zst -
Burn the Fedora image to the micro-SD card by running the following command.
sudo dd if=Fedora-riscv64-jh7100-developer-xfce-Rawhide-20211226-214100.n.0-sda.raw of=/dev/sdX bs=8M status=progress && syncInformation:
- If you are a Mac user, burn the Fedora image to the micro-SD card by running:
sudo dd if=Fedora-riscv64-jh7100-developer-xfce-Rawhide-20211226-214100.n.0-sda.raw of=/dev/sdX bs=8m && sync of=/dev/sdXcorresponds to the location of the connected micro-SD card. You can find this by runninglsblkcommand.- The whole burning process will take about 20 minutes.
- If you are a Mac user, burn the Fedora image to the micro-SD card by running:
¶ Logging in to Fedora
¶ Using Xfce Desktop over HDMI
After installing Fedora, you can log in to Fedora OS on VisionFive using Xfce Desktop over HDMI.
Steps:
-
After the HDMI of the display screen is connected, insert the micro-SD card with the Fedora image into the VisionFive and power on.
-
After the desktop login system is displayed, you can use the keyboard and mouse on VisionFive.
-
Enter the credentials as follows:
-
Username: riscv (default)
-
Password: starfive
Result:
You will see the following interface:
Figure - UI Example
-
¶ Using SSH over Ethernet
After installing Fedora, you can log in to Fedora OS on VisionFive through an SSH connection over the local network.
Steps:
-
Insert the micro-SD card with the Fedora image into the VisionFive and power on.
-
Connect one end of an Ethernet cable to the RJ45 connector on the VisionFive and the other end of the cable to a router.
-
After successful Ethernet connection, your router will assign an IP address to the VisionFive and it will be connected to the Internet.
¶ For Windows
Steps:
-
Log in to your router (usually you need to enter 192.168.1.1 on the web browser to enter the router).
-
Go to DHCP configuration and find the IP address of the VisionFive.
Information:
You can easily find the IP address of the VisionFive by referring to its host name, fedora-starfive. -
Download and install Putty by visiting this link.
Information:
Putty is an SSH and telnet client through which you can connect to the Carrier Board. You can skip this step if you already have Putty installed. -
Open Putty to log in to Fedora.
-
Select SSH under the Connection Type.
-
Configure the settings as follows:
-
Host Name: IP address of your VisionFive
-
Port: 22
-
Click Open.
-
Enter the credentials as follows:
- Username: riscv
- Password: starfive
Result:
Now you have connected with the VisionFive via SSH using windows!
Figure - Example Output
¶ For Mac/Linux
Steps:
-
Log in to your router (usually you need to enter 192.168.1.1 on the web browser to enter the router).
-
Go to DHCP configuration and find the IP address of the VisionFive.
Information:
You can easily find the IP address of the VisionFive by referring to its host name, fedora-starfive. -
Open a terminal window and type the following:
ssh riscv@192.168.1.xxxInformation:
192.168.1.xxxis the IP address of VisionFive. -
Type the password as starfive in the prompt.
Result:
Now you have connected with the VisionFive via SSH using Mac/Linux!Information:
192.168.1.xxxis the IP address of VisionFive.
Figure - Example Output
¶ Using a USB to Serial Converter
You can log in to Fedora OS on VisionFive using a USB-to-Serial converter. Please follow the following steps:
¶ For Windows
Steps:
-
Insert the micro-SD card with the Fedora image burnt into VisionFive.
-
Connect one end of the USB Type-C cable to the USB Type-C port on the VisionFive, and connect the other end of the cable to the power adapter.
-
Connect the jumper wires from the USB to Serial Converter to the 40-Pin GPIO header of the VisionFive as follows.
Figure - Connecting Jumper Wire -
Connect the USB-to-Serial converter to the PC.
-
Open Device Manager by typing Device Manager in the windows search box.
-
Click the drop-down arrow from Ports (COM & LPT) and find the name of the connected serial port (e.g.: COM4).
Figure - Example -
Download and install Putty by visiting this link.
Information:
Putty is an SSH and telnet client through which you can connect to the Carrier Board via SSH. You can skip this step if you already have Putty installed. -
Open Putty to connect the PC to the Carrier Board.
-
Select Serial under the Connection Type.
-
Configure the settings as follows:
-
Serial line: COM4 (choose your COM port)
-
Speed: 115200
Figure - Example Configuration
-
-
Click Open.
-
Power on the VisionFive.
-
Type username and password in the prompt as follows:
- Username: riscv
- Password: starfive
Result:
Now you have connected with the VisionFive via serial communication using windows!
Figure - Example Output
¶ For Mac/Linux
Steps:
-
Insert the micro-SD card with the Fedora image burnt into VisionFive.
-
Connect one end of the USB Type-C cable to the USB Type-C port on the VisionFive, and connect the other end of the cable to the power adapter.
-
Connect the jumper wires between the USB-to-Serial converter and the 40-Pin GPIO header of the VisionFive as follows.
Figure - Connecting Jumper Wires -
Connect the USB-to-Serial converter to the PC.
-
Open a terminal window on Mac/Linux.
-
Update the packages list by typing the following command.
sudo apt-get update -
Install minicom by typing the following command.
sudo apt-get install minicom -
View the connected serial devices.
dmesg | grep tty
Figure - Example Output -
Connect to the serial device by typing the following command.
sudo minicom -D /dev/ttyUSB0 -b 115200Information:
The baud rate is set to 115200.
Figure - Example Output -
Power on the VisionFive
-
Type username and password in the prompt as follows:
- Username: riscv
- Password: starfive
Result:
Now you have connected with the VisionFive via serial communication using Mac/Linux!
Figure - Example Output
¶ Appendix A: VisionFive Boot Flow
Figure ‑ VisionFive Boot Flow
¶ Appendix B: Updating Firmware and u-boot
¶ Using Pre-Built Binary Packages
Information:
Follow the GitHub repo. Update the firmware and U-Boot if there is an update notice. Refer to the Appendix D chapter in this document for the link to the repo.
Please visit the following links to download the bootloader, ddr init and u-boot files.
¶ Hardware Connection
To connect hardware, perform the following:
Steps:
-
Connect one end of the USB Type-C cable to the USB Type-C port on the VisionFive, and connect the other end of the cable to the power adapter.
-
Connect the jumper wires between the USB-to-Serial converter and the 40-Pin GPIO header of the VisionFive as follows.
Figure - Connecting the Jumper Wires -
Connect the power adapter to a power socket.
¶ Software Setup
Before you update the Bootloader, ddr init and u-boot, you need to have a serial communication software on your computer in order to communicate with the VisionFive.
Follow the steps below according to your operating system.
For Windows:
- Install Tera Term for windows as described in Installing Tera Term.
- Update
bootloader,u-boot, andddr initby:- using Xmodem as described in the Using Xmodem section.
- or using Ethernet as described in the Using Ethernet section.
For Mac/Linux:
- Install minicom on Mac/Linux as described in Installing Minicom.
- Update
bootloader,u-boot, andddr initby:- using Xmodem as described in the Using Xmodem section.
- or using Ethernet as described in the Using Ethernet section.
¶ For Windows
¶ Installing Tera Term
Steps:
-
Download Tera Term by visiting this link.
-
Install Tera Term on the PC.
-
Connect the USB-to-Serial converter to the PC.
-
Open Device Manager by typing Device Manager in the windows search box.
-
Click the drop-down arrow from Ports (COM & LPT) and find the name of the connected serial port (e.g.: COM4).
Figure - Example -
Open Tera Term software.
-
Navigate to Setup > Serial port...
-
Configure the settings as follows:
- Port: COM4 (choose your COM port)
- Speed: 115200
Figure - Example
-
Click New > open.
¶ Using Xmodem
-
After the hardware connections mentioned above, power on the VisionFive and you will see the startup information as follows.
Figure - Startup Information Example -
Press any key as soon as it starts up to enter the upgrade menu. In this menu, you can only update u-boot.
Figure - Update Uboot -
Type root@s5t and press Enter to enter the extended version of the upgrade menu. In this menu, you can update u-boot, bootloader and ddr init.
Figure - Example Output -
Type 0 and press Enter to update the bootloader.
-
Navigate to File > Transfer > XMODEM > Send... and choose the
.outfile from the .zip file we downloaded before:
bootloader-JH7100-211102.bin.out -
Repeat the steps 4 and 5 to update the ddr init as well according to the following:
- Type 1 - update ddr init [Filename: ddrinit-2133-211102.bin.out]
-
Repeat the steps 4 and 5 to update the u-boot as well according to the following:
- Type 2 - update u-boot [Filename: fw_payload.bin.out]
¶ Using Ethernet
-
Connect one end of an Ethernet cable to the VisionFive RJ45 connector, and connect the other end of the cable to a router.
-
Download TFTPD64 from tftpd64.
-
Install TFTPD64 on your PC.
-
Open TFTPD64 and configure the Current Directory, which specifies the file path to store
bootloader,ddr init, andu-bootfiles. The following figure shows an example configuration:
Example Settings -
Power on the VisionFive and wait until it enters the u-boot mode.
-
Configure the environment variables by executing:
setenv ipaddr 192.168.120.200;setenv serverip 192.168.120.12Generally, the default IP of a router is 192.168.120.1. In this case, use the server IP as the IP assigned by the DHCP server of the router and use the VisionFive IP as 192.168.120.xxx. However, if your router IP is different (for example, 192.168.2.1 ), make sure the server IP and VisionFive IP are in the same IP domain (for example, 192.168.2.xxx).
-
Check the connectivity by pinging the host PC from VisionFive:
Example Command:ping 192.168.120.12Result:
The following output indicates that the host PC and VisionFive has established communication on the same network.
Figure - Example Output -
Connect to SPI Flash:
sf probeExample Output:
Figure - Example OutputInformation:
- In the commands of the following step 9 to 11:
0x90000000refers to the ddr address192.168.120.12refers to the tftp server IP0x0refers to the SPI flash offset forbootloader.0x10000refers to the SPI flash offset forddrinit.0x40000refers to the SPI flash offset foru-boot.
- If VisionFive fails to boot up after restart, refer to the Appendix C: Recovering the Bootloader chapter to recover.
- In the commands of the following step 9 to 11:
-
Update
bootloader:tftpboot 0x90000000 192.168.120.12:bootloader-JH7100-211102.bin.out sf update 0x90000000 0x0 ${filesize}Example Output:
Figure - Example Output -
Update
ddr init:tftpboot 0x90000000 192.168.120.12:ddrinit-2133-211102.bin.out sf update 0x90000000 0x10000 ${filesize}Example Output:
Figure - Example Output -
Update
u-boot:tftpboot 0x90000000 192.168.120.12:fw_payload_visionfive.bin.out sf update 0x90000000 0x40000 ${filesize}Example Output:
Figure - Example Output -
Restart VisionFive to make the updates take effect.
¶ For Mac/Linux
¶ Installing Minicom
Steps:
-
Open a terminal window on Mac/Linux.
-
Type the following to update the packages list.
sudo apt-get update -
Type the following to install minicom.
sudo apt-get install minicom -
Connect the USB-to-Serial converter to the PC.
-
Type the following in the terminal to view the connected serial devices.
dmesg | grep tty
Figure - Example Output -
Connect to the serial device by typing the following.
sudo minicom -D /dev/ttyUSB0 -b 115200Information:
The baud rate is set to 115200.
Figure - Example
¶ Using Xmodem
-
After the hardware connections mentioned above, power on the VisionFive and you will see the startup information as follows.
Figure - Example -
Press any key as soon as it starts up to enter the upgrade menu. In this menu, you can only update u-boot.
Figure - Example -
Type root@s5t and press Enter to enter the extended version of the upgrade menu, and in this menu, you can update u-boot, bootloader and ddr init.
Figure - Example -
Type 0 and press Enter to update the bootloader.
-
Press Ctrl+A and then press S to enter upload mode.
-
Select xmodem and press Enter.
Figure - Example -
Select Goto from the bottom tab menu and press Enter.
Figure - Example -
Enter the directory path and press Enter.
Figure - Example -
Select
bootloader-JH7100-211102.bin.outby navigating using arrow keys, press Space and press Enter. -
Repeat the steps from 4 to 9 to update the ddr init as well according to the following:
- Type 1 - update ddr init [Filename: ddrinit-2133-211102.bin.out]
-
Repeat the steps from 4 to 9 to update the u-boot as well according to the following:
- Type 2 - update u-boot [Filename: fw_payload.bin.out]
¶ Using Ethernet
-
Connect one end of an Ethernet cable to the VisionFive RJ45 connector, and connect the other end of the cable to a router.
-
Install a tftp server on the host PC by executing:
sudo apt-get update sudo apt install tftpd-hpa -
Check the server status:
sudo systemctl status tftpd-hpa -
Execute the following to enter the tftp server:
sudo nano /etc/default/tftpd-hpa -
Configure the tftp server as follows:
TFTP_USERNAME="tftp" TFTP_DIRECTORY="/home/user/Desktop/tftp_share" TFTP_ADDRESS=":69" TFTP_OPTIONS="--secure"Information:
TFTP_DIRECTORYrefers to the directory to storebootloader,ddr init, andu-bootfiles. -
Restart the tftp server by executing:
sudo systemctl restart tftpd-hpa -
Power on the VisionFive and wait until it enters the u-boot mode.
-
Configure the environment variables by executing:
setenv ipaddr 192.168.120.200;setenv serverip 192.168.120.12Generally, the default IP of a router is 192.168.120.1. In this case, use the server IP as the IP assigned by the DHCP server of the router and use the VisionFive IP as 192.168.120.xxx. However, if your router IP is different (for example, 192.168.2.1 ), make sure the server IP and VisionFive IP are in the same IP domain (for example, 192.168.2.xxx).
-
Check the connectivity by pinging the host PC from VisionFive:
Example Command:ping 192.168.120.12Result:
The following output indicates that the host PC and VisionFive has established communication on the same network.
Figure - Example Output -
Connect to SPI Flash:
sf probeExample Output:
Figure - Example OutputInformation:
- In the commands of the following step 11 to 14:
0x90000000refers to the ddr address192.168.120.12refers to the tftp server IP0x0refers to the SPI flash offset forbootloader.0x10000refers to the SPI flash offset forddrinit.0x40000refers to the SPI flash offset foru-boot.
- If VisionFive fails to boot up after restart, refer to the Appendix C: Recovering the Bootloader chapter to recover.
- In the commands of the following step 11 to 14:
-
Update
bootloader:tftpboot 0x90000000 192.168.120.12:bootloader-JH7100-211102.bin.out sf update 0x90000000 0x0 ${filesize}Example Output:
Figure - Example Output -
Update
ddr init:tftpboot 0x90000000 192.168.120.12:ddrinit-2133-211102.bin.out sf update 0x90000000 0x10000 ${filesize}Example Output:
Figure - Example Output -
Update
u-boot:tftpboot 0x90000000 192.168.120.12:fw_payload_visionfive.bin.out sf update 0x90000000 0x40000 ${filesize}Example Output:
Figure - Example Output -
Restart VisionFive to make the updates take effect.
Information:
The methods to compile and update u-boot are included in the following: VisionFive_Software_Technical_Reference_Manual.
¶ Appendix C: Recovering the Bootloader
The bootloader is stored inside the SPI flash storage. There may be situations where you accidentally emptied the flash or if the flash is damaged on your VisionFive. In these situations, it's better to reset the bootloader. Follow the steps below to load JH7100_recovery_boot.bin to on-chip SRAM, run it, and then flash bootloader, ddr init and u-boot.
¶ Hardware Setup
Connect the jumper wires between the USB-to-Serial converter and the DEBUG header of the VisionFive as follows.
Figure - Connecting the Debug Header
¶ Software Setup
Before you recover the bootloader, you need to have a serial communication software on your computer in order to communicate with the VisionFive. We will use:
- a software called Tera Term for windows as described in For Windows
- a Bootloader recovery and updater tool for Mac/Linux as described in For Mac/Linux.
Follow the steps below according to your operating system.
¶ For Windows
-
Open Tera Term software.
-
Navigate to Setup > Serial port...
-
Configure the settings as follows.
-
Port: COM4 (choose your COM port)
-
Speed: 9600
-
-
Click on New open.
-
Press the BOOT button while turning on VisionFive.
Figure - Pressing the Boot Button -
You will see the following output on Tera Term.
(C) SiFive -
Type the following.
load 0x18000000Result:
You will see an output like this:
-
Navigate to File > Transfer > XMODEM > Send... and choose the following file we downloaded before:
JH7100_recovery_boot.bin.
Result:
You will see an output like this after the transfer is complete.Load file ok. -
Type the following.
do 0x18000000Result:
You will see an output like this:
Figure - Example Output -
Type 0 and press Enter to update the bootloader.
-
Navigate to File > Transfer > XMODEM > Send... and choose the following file from the .zip file we downloaded before:
bootloader-JH7100-211102.bin.out -
Repeat the steps 10 and 11 to update the ddr init according to the following.
- Type 1 - update ddr init [Filename: ddrinit-2133-211102.bin.out]
¶ For Mac/Linux
-
Clone the following GitHub repo which includes a bootloader recovery and updater tool.
git clone https://github.com/xypron/JH71xx-tools/ -
Navigate to the cloned repo and build the tool.
cd JH71xx-tools gcc -o jh7100-recover jh7100-recover.c -
Copy
JH7100_recovery_boot.bin,bootloaderandddr initto theJH71xx-toolsdirectory.Information:
This step is not a must, but it makes it more convenient in the following steps when we point to the file locations. -
Type the following in the terminal to view the connected serial devices.
dmesg | grep ttyExample Output:
Figure - Example Output -
Type the following and it will wait for bootloader mode.
sudo ./jh7100-recover -D /dev/ttyUSB0 -r jh7100_recovery_boot.bin -b bootloader-JH7100-211102.bin.out -d ddrinit-2133-211102.bin.outExample Output:
Figure - Example OutputInformation:
You may change the serial port according to yours and also the file locations if you haven't moved them into the JH71xx-tools directory. -
Press on the BOOT button while turning on VisionFive to enter bootloader mode.
Example Result:
If you see the following output, you have successfully updatedbootloaderandddr init.
Figure - Example Output
¶ Appendix D: GitHub Repository
The following table describes the links to GitHub repository:
Table ‑ GitHub Repository
| Type | Item | Description | Repositories |
| StarFive firmware | Boot_recovery | Binary for recovering SPI flash | |
| secondboot | First stage bootloader | ||
| ddrinit | First stage bootloader | ||
| RISC-V SBI | openSBI | RISC-V specific | |
| Bootloader | u-boot | Universal boot loader | |
| Kernel | Linux | Linux Kernel | |
| Distro | Fedora Image | Fedora 33 image |