From Waveshare Wiki
Jump to: navigation, search

MG BXE-4-32
CPU: RISC-V U74 quad-core 64-bit V64GC ISA SoC
Memory: 4G/8G Byte LPDDR4
Storage: External SD card/eMMC





Onboard RV64GC ISA Quad-core 64-bit SoC, operating frequency up to 1.5GHz, VisionFive 2 supports OpenCL 3.0, OpenGL ES 3.2, and Vulkan 1.2. It is available in 4GB/8GB LPDDR4 RAM options and an optional wireless module. Also, it has multiple onboard interfaces, including M.2 / CSI / DSI / HDMI / eMMC / USB 3.0 / 40PIN GPIO / RJ45 Gigabit Ethernet port / TF card slot, etc. Supports 4K@60fps and H264/H265 multi-stream video decoding, 1080p@30fps and H265 multi-stream video encoding. Onboard 40PIN GPIO header, VisionFive2 is compatible with Raspberry Pi series boards. Provides wide software compatibility including support for Debian.


Processor StarFive JH7110
CPU RISC-V U74 Quad-core 64-bit V64GC ISA [email protected]
Memory 4G/8G Byte LPDDR4
Storage TF card/eMMC
Camera MIPI CSI 2lane × 1
Display Port HDMI 2.0 × 1 (4K@30fps or 2K@60fps);
2-lane MIPI DSI × 1 (1080p@30fps);
4-lane MIPI DSI × 1 (2K@30fps);
Only one DSI port can be used for display at the same time.
USB Host USB Type-A 3.0 × 4
USB Device USB Device × 1; multiplexed with the USB Type-C port
Networking 1 × Gigabit Ethernet port (main Ethernet port) (near the edge of the board);
1 × 100/10M Ethernet port
Others 40PIN × 1;
M.2 M-Key SSD slot;
2Pin fan header;
3.5mm Audio Jack
Power Supply Supports Quick Charge input 5V DC (minimum 3A) (up to 30 W)
Supports 5~20V fixed voltage input
Supports USB Type-C PD 2.0, 9V/2A, 12V/2A, 15V/2A, 20V/2A
Supports QC 3.0/2.0 adapter, 9V/2A, 12V/1.5A
Dimensions 100 × 74 × 21 mm
Recommended Operating Ambient Temperature 0~50℃ (If the operating temperature of the chip exceeds 85°C, the frequency and voltage of the CPU will be automatically reduced for cooling.)

User Guide

As the Debian image is large, it is recommended to use a TF card of 32GB or above.

Install Debian System

Download, open SDFormatter, and format the corresponding TF card.
Jetson Nano Image01.jpg
Download, open, choose the corresponding image and disk, and click "write".


Turn the two DIP switches on the board to the right (ON) position.
Insert the TF card that burned the image, connect the USB to TTL module according to the figure, connect it to the PC, and check the port. VisionFive209.jpg
Open MobaXterm and operate as shown below:
Connect the network cable and power supply, try to print the U-boot to the position shown in the picture, and press any key to switch to the device tree.
Enter the following command (to be entered line by line):

ext4load mmc 1:3 a0000000 /boot/uEnv.txt
env import a0000000 17c
setenv fdtfile starfive/jh7110-visionfive-v2.dtb
sysboot mmc 1:3 ext2 b0000000 /boot/extlinux/extlinux.conf

Wait a few seconds and it will automatically enter the system (if you have selected it before, you must select it before entering the system).
Enter the corresponding account and password:
Username: root
Password: starfive

Extended file system ensures that all storage on the memory card is available

Query memory space: df -h.
Enter the commands: fdisk /dev/mmcblk1.
Input according to the content shown in the picture, and press Enter directly at positions 5 and 6.
Enter the command: resize2fs /dev/mmcblk1p3.
Then use df -h to view the size of the space.

Check IP

The net-tools toolbox is not installed on the Debian system, so it needs to be installed manually.
Use command:

apt-get install net-tools

After the installation is complete, you can use the command ifconfig to view the IP of the corresponding network port.

Connect To SSH

The Debian system of VisionFive2 does not support the root user to use an ssh connection, so it needs to be set according to the following configuration.
Edit the ssh configuration file.

nano /etc/ssh/sshd_config

Add the following two sentences at the end of the file:

PasswordAuthentication yes 
PermitRootLogin yes

Save, exit, and restart the ssh service.
service sshd restart or systemctl restart sshd.service use MobaXterm software to ssh connection to VisionFive2, if the connection fails, restart VisionFive2.

Working with ECR660U-WiFi Module

This module is only available on 202302 and later Debian systems.


Connect to the WiFi module; the serial port prints nothing.
Use ifconfig -a command, two devices starting with wl will show up to indicate a successful connection.
ECR660U-WiFi 01.jpg
Normally, wl is followed by the fixed MAC address of the WiFi, e.g:

wlx2c0547a116fa address: 2c:05:47:a1:16:fa
wlx2c0547a116fb address: 2c:05:47:a1:16:fb

However, before connecting to WiFi, visionfive2 will randomly give a virtual MAC address to the device from time to time, at which point we can use the following actions to determine the real address of the module.
Install iw:

apt-get install iw

View the device information:

ip link

ECR660U-WiFi 02.jpg
As shown in the picture, the above two are the real addresses of the modules.
If you don't like the name, you can change it as follows:

nano /etc/udev/rules.d/70-persistent-net.rules
# Add the following "2c:05:47:a1:16:fa" and "2c:05:47:a1:16:fb" as the real addresses you just got
SUBSYSTEM=="net", ACTION=="add", DRIVERS=="? *", ATTR{address}=="2c:05:47:a1:16:fa", ATTR{dev_id}=="0x0", ATTR{type}=="1", NAME="wlan0" 
SUBSYSTEM=="net", ACTION=="add", DRIVERS=="? *", ATTR{address}=="2c:05:47:a1:16:fb", ATTR{dev_id}=="0x0", ATTR{type}=="1", NAME="p2p1"
# Update udev rules
udevadm control --reload-rules

Reinstall the WiFi module.
After using the ifconfig -a command, you will see that the name of wlxxxxxxx has been changed.
ECR660U-WiFi 03.jpg

Connect to WiFi

Enter nmtui to access the graphical interface for network configuration:
VisionFive2 WiFi 01.jpg
Select the second option
VisionFive2 WiFi 02.jpg
Select the WiFi you want to connect to, the * sign at the end of the WiFi indicates the signal strength:
VisionFive2 WiFi 03.jpg
Enter the password and press Enter.
VisionFive2 WiFi 04.jpg
An * sign appears in front of the corresponding WiFi to indicate a successful connection.
VisionFive2 WiFi 05.jpg
Press Esc to go back to the main screen and select the first option.
VisionFive2 WiFi 06.jpg
The name of the WiFi you just connected to appears as shown in the picture, which means that the system has remembered this WiFi and will try to connect to it automatically the next time you turn on your computer.
VisionFive2 WiFi 07.jpg
Go back to the terminal and enter the ifconfig command, you can see that the WiFi is getting the IP and displaying the real MAC address.
VisionFive2 WiFi 08.jpg

Adapted Products






Learning Module



Official Resource/Forum Address


Debian Image

Development Software



Official website introduction:
Brief summary:
1. Can use SD, eMMc boot mode to boot.
2. Use Flash mode to boot, need to update Flash firmware.
3. The image is greatly reduced to 2GB, if you need the full function, please use the following command after logging into the system.

chmod +x



There is a little problem with the system startup directory.
Enter the following document, follow the 4.4 section, and restore the Bootloader operation to operate.



The debian system version is too old, Flash firmware version is too old.
Download the latest Debian image.
Just follow #Update Onboard Flash Firmware.




If you require technical support, please go to the Support page and open a ticket.